NAME¶
HTML::FormFu::Element::DateTime - Date / Time combo field
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.