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::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.

cpanm HTML::FormFu

perl -MCPAN -e shell
install HTML::FormFu