---
name: "Data::FormValidator::Constraints::Dates"
section: "3pm"
platform: "linux"
package: "libdata-formvalidator-perl"
version: "4.88-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Data::FormValidator::Constraints::Dates"
---

# Data::FormValidator::Constraints::Dates(3pm)

Validate Dates and Times

## NAME

Data::FormValidator::Constraints::Dates - Validate Dates and Times

## SYNOPSIS

```
    use Data::FormValidator::Constraints::Dates qw(date_and_time);
    # In a DFV profile...
    constraint_methods => {
        # 'pp' denotes AM|PM for 12 hour representation
        my_time_field => date_and_time('MM/DD/YYYY hh:mm:ss pp'),
    }
```

## DESCRIPTION

### date\_and\_time

**Note:** This is a new module is a new addition to Data::FormValidator and is should be considered "Beta".

This constraint creates a regular expression based on the format string passed in to validate your date against. It understands the following symbols:

```
    Y   year  (numeric)
    M   month (numeric)
    D   day   (numeric)
    h   hour
    m   minute
    s   second
    p   AM|PM
```

Other parts of the string become part of the regular expression, so you can do perlish things like this to create more complex expressions:

```
    'MM?/DD?/YYYY|YYYY-MM?-DD?'
```

Internally Date::Calc is used to test the functions.

## BACKWARDS COMPATIBILITY

This older, more awkward interface is supported:

```
    # In a Data::FormValidator Profile:
    validator_packages => [qw(Data::FormValidator::Constraints::Dates)],
    constraints => {
        date_and_time_field       => {
            constraint_method => 'date_and_time',
            params=>[\'MM/DD/YYYY hh:mm:ss pp'], # 'pp' denotes AM|PM for 12 hour representation
        },
    }
```

## SEE ALSO

- o

  Data::FormValidator

- o

  Data::FormValidator::Constraints::DateTime  - This alternative features returning dates as DateTime objects and validating against the date formats required for the MySQL and PostgreSQL databases.

## AUTHOR

Mark Stosberg, \<mark@summersault.com\>

Featuring clever code by Jan Krynicky.

## COPYRIGHT AND LICENSE

Copyright 2003-2005 by Mark Stosberg

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.