Workflow::Validator::MatchesDateFormat - Ensure a stringified date matches a given pattern


NAME

Workflow::Validator::MatchesDateFormat - Ensure a stringified date matches a given pattern


SYNOPSIS

 <action name="CreateNews">
   <validator name="DateFormat">
      <param name="date_format" value="%Y-%m-%d"/>
      <arg value="$news_post_date"/>
   </validator>
 </action>


VERSION

This documentation describes version 1.04 of the Workflow::Validator::MatchesDateFormat manpage


DESCRIPTION

This validator ensures that a given date string matches a strptime pattern. The parameter 'date_format' is used to declare the pattern against which the date string must be matched, and the single argument is the date to match.

The 'date_format' pattern is a typical strptime pattern. See the DateTime::Format::Strptime manpage for details.

NOTE: If you pass an empty string (or no string) to this validator it will not throw an error. Why? If you want a value to be defined it is more appropriate to use the 'is_required' attribute of the input field to ensure it has a value.

Also, if you pass a DateTime object to the validator it will not determine whether the date is correct or within a range. As far as it is concerned its job is done.

METHODS

_init

This method initializes the class and the enumerated class.

It uses add_enumerated_values to add the set of values for enumeration.

The primary parameter is value, which should be used to specify the either a single value or a reference to array of values to be added.

validate

The validator method is the public API. It works with Workflow.

Based on the initialized the Workflow::Validator manpage it validates a provided parameter, which should adhere to a predefined date format.


EXCEPTIONS


SEE ALSO

Workflow
the Workflow::Validator manpage
the Workflow::Exception manpage
DateTime


COPYRIGHT

Copyright (c) 2003-2007 Chris Winters. All rights reserved.

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


AUTHORS

Current maintainer Jonas B. Nielsen <jonasbn@cpan.org>

Original author Chris Winters <chris@cwinters.com>

 Workflow::Validator::MatchesDateFormat - Ensure a stringified date matches a given pattern