man > Data::FormValidator::Constraints::Dates

man perldoc info pydoc3 ri search

📛 NAME

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

🚀 Quick Reference

Use Case	Command	Description
🔍 Validate a date/time field with a format string	date_and_time('MM/DD/YYYY hh:mm:ss pp')	🧪 Uses regex generated from format string, validates with Date::Calc
🔄 Older interface (DFV profile)	validated_packages => [...]	📜 Supports constraint_method and params with scalar reference
📅 Validate against multiple formats	'MM?/DD?/YYYY|YYYY-MM?-DD?'	🔗 Combine formats with pipe (|) in the string

📖 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

• Data::FormValidator
• 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 AT 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.

📋 perl v5.26.1 2017-10-24 Data::FormValidator::Constraints::Dates(3pm)

📛 NAME 🚀 Quick Reference 📖 SYNOPSIS 📝 DESCRIPTION 🔄 BACKWARDS COMPATIBILITY 🔗 SEE ALSO 👤 AUTHOR 📄 COPYRIGHT AND LICENSE