---
name: "HTML::FormFu::Element::DateTime"
section: "3pm"
platform: "linux"
package: "libhtml-formfu-perl"
version: "2.07000-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/HTML::FormFu::Element::DateTime"
---

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

Date / Time combo field

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