jonasbn > Workflow-1.41 > Workflow::Validator::MatchesDateFormat

Download:
Workflow-1.41.tar.gz

Dependencies

Annotate this POD

Website

CPAN RT

New  4
Open  2
View/Report Bugs
Module Version: 1.06   Source  

NAME ^

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

VERSION ^

This documentation describes version 1.06 of this package

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 Workflow::Validator::MatchesDateFormat

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 DateTime::Format::Strptime 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 Workflow::Validator it validates a provided parameter, which should adhere to a predefined date format.

EXCEPTIONS ^

SEE ALSO ^

Workflow
Workflow::Validator
Workflow::Exception
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>

syntax highlighting: