HTML::FormFu::Element::DateTime(3)

NAME
HTML::FormFu::Element::DateTime - Date / Time combo field

VERSION
version 2.07

SYNOPSIS
    ---
    elements:
      - type: DateTime
        name: start_datetime
        label: 'Start:'
        auto_inflate: 1

DESCRIPTION
Sub-class of Date element, providing extra "hour" and "minute" Select menus.

METHODS

  hour
Arguments: \%setting

Set values effecting the "hour" select menu. Known keys are:

name

Override the auto-generated name of the select menu.

default

Set the default value of the select menu

prefix

Arguments: $value

Arguments: \@values

A string or arrayref of strings to be inserted into the start of the select menu.

Each value is only used as the label for a select item - the value for each of these items is always the empty string ''.

prefix_loc

Arguments: $localization_key

Arguments: \@localization_keys

A localized string or arrayref of localized strings to be inserted into the start of the select menu.

Each value is localized and then only used as the label for a select item - the value for each of these items is always the empty string ''.

Use "prefix_loc" insted of "prefix".

  minute
Arguments: \%setting

Set values effecting the "minute" select menu. Known keys are:

name

Override the auto-generated name of the select menu.

default

Set the default value of the select menu

prefix

Arguments: $value

Arguments: \@values

A string or arrayref of strings to be inserted into the start of the select menu.

Each value is only used as the label for a select item - the value for each of these items is always the empty string ''.

prefix_loc

Arguments: $localization_key

Arguments: \@localization_keys

A localized string or arrayref of localized strings to be inserted into the start of the select menu.

Each value is localized and then only used as the label for a select item - the value for each of these items is always the empty string ''.

Use "prefix_loc" insted of "prefix".

  second
Arguments: \%setting

Set values effecting the "second" select menu. Known keys are:

name

Override the auto-generated name of the select menu.

default

Set the default value of the select menu

prefix

Arguments: $value

Arguments: \@values

A string or arrayref of strings to be inserted into the start of the select menu.

Each value is only used as the label for a select item - the value for each of these items is always the empty string ''.

prefix_loc

Arguments: $localization_key

Arguments: \@localization_keys

A localized string or arrayref of localized strings to be inserted into the start of the select menu.

Each value is localized and then only used as the label for a select item - the value for each of these items is always the empty string ''.

Use "prefix_loc" insted of "prefix".

  field_order
Arguments: \@fields

Default Value: ['day', 'month', 'year', 'hour', 'minute']

Specify the order of the date fields in the rendered HTML.

If you want the "second" selector to display, you must set both "/field_order" and strftime yourself. Eg:

    elements:
      type: DateTime
      name: foo
      strftime: '%d-%m-%Y %H:%M:%S'
      field_order: ['day', 'month', 'year', 'hour', 'minute', 'second']

Not all fields are required. No single field can be used more than once.

CAVEATS
See "CAVEATS" in HTML::FormFu::Element::Date

SEE ALSO
Is a sub-class of, and inherits methods from HTML::FormFu::Element::Date HTML::FormFu::Role::Element::Field, HTML::FormFu::Element::Multi, HTML::FormFu::Element::Block, HTML::FormFu::Element

HTML::FormFu

AUTHOR
Carl Franks, "cfranks@cpan.org"

LICENSE
This library is free software, you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR
Carl Franks <cpan@fireartist.com>

COPYRIGHT AND LICENSE
This software is copyright (c) 2018 by Carl Franks.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.