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

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

DateTime inflator

## NAME

HTML::FormFu::Inflator::DateTime - DateTime inflator

## VERSION

version 2.07

## SYNOPSIS

```
    ---
    elements:
      - type: Text
        name: start_date
        inflators:
          - type: DateTime
            parser:
              strptime: '%d-%m-%Y'
            strptime:
              pattern: '%d-%b-%Y'
              locale: de
      - type: Text
        name: end_time
        inflators:
          - type: DateTime
            time_zone: Europe/Rome
            parser:
              regex: '^ (\d{2}) - (\d{2}) - (\d{4}) $'
              params: [day, month, year]
            strptime: '%d-%m-%Y'
```

An example of using the same parser declaration for both a DateTime constraint and a DateTime inflator, using YAML references:

```
    ---
    elements:
      - type: Text
        name: date
        constraints:
          - type: DateTime
            parser: &PARSER
              strptime: '%d-%m-%Y'
        inflators:
          - type: DateTime
            parser: *PARSER
```

## DESCRIPTION

Inflate dates into DateTime objects.

For a corresponding deflator, see HTML::FormFu::Deflator::Strftime.

## METHODS

### parser

Arguments: \\%args

Required. Define the expected input string, so DateTime::Format::Builder knows how to inflate it into a DateTime object.

Accepts arguments to be passed to "parser" in DateTime::Format::Builder.

### strptime

Arguments: \\%args

Arguments: `$string`

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

### time\_zone

Arguments: `$string`

Optional. You can pass along a time\_zone in which the DateTime will be created. This is useful if the string to parse does not contain time zone information and you want the DateTime to be in a specific zone instead of the floating one (which is likely).

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 )"`.

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