---
name: "HTML::FormFu::Inflator::CompoundDateTime"
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::Inflator::CompoundDateTime"
---

# HTML::FormFu::Inflator::CompoundDateTime(3pm)

CompoundDateTime inflator

## NAME

HTML::FormFu::Inflator::CompoundDateTime - CompoundDateTime inflator

## VERSION

version 2.07

## SYNOPSIS

```
    ---
    element:
      - type: Multi
        name: date
        elements:
          - name: day
          - name: month
          - name: year
        inflator:
          - type: CompoundDateTime
    # get the submitted value as a DateTime object
    my $date = $form->param_value('date');
```

## DESCRIPTION

For use with a HTML::FormFu::Element::Multi group of fields.

Changes the input from several fields into a single DateTime value.

By default, expects the field names to be any of the following:

- year

  - month

  - day

  - hour

  - minute

  - second

  - nanosecond

  - time\_zone

  ## METHODS

### field\_order

Arguments: \\@order

If your field names doesn't follow the convention listed above, you must provide an arrayref containing the above names, in the order they correspond with your own fields.

```
    ---
    element:
      - type: Multi
        name: date
        elements:
          - name: m
          - name: d
          - name: y
        inflator:
          - type: CompoundDateTime
            field_order:
              - month
              - day
              - year
```

### strptime

Arguments: \\%args

Arguments: `$string`

Optional. Define the format that should be used if the DateTime object is stringified.

Accepts a hashref of arguments to be passed to "new" in DateTime::Format::Strptime. Alternatively, accepts a single string argument, suitable for passing to `"DateTime::Format::Strptime->new( pattern => $string )"`.

```
    ---
    inflator:
      - type: CompoundDateTime
        strptime:
          pattern: '%d-%b-%Y'
          locale: de
    ---
    inflator:
      - type: CompoundDateTime
        strptime: '%d-%m-%Y'
```

## AUTHOR

Carl Franks

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