DateTime::Format::Builder::Parser::Regex - Regex based date parsing
my $parser = DateTime::Format::Builder->create_parser( regex => qr/^(\d\d\d\d)(\d\d)(\d\d)T(\d\d)(\d\d)(\d\d)$/, params => [ qw( year month day hour minute second ) ], );
In addition to the common keys, Regex supports:
Regex
regex is a regular expression that should capture elements of the datetime string. This is a required element. This is the key whose presence indicates it's a specification that belongs to this class.
params is an arrayref of key names. The captures from the regex are mapped to these ($1 to the first element, $2 to the second, and so on) and handed to DateTime->new(). This is a required element.
$1
$2
DateTime->new()
extra is a hashref of extra arguments you wish to give to DateTime->new(). For example, you could set the year or time_zone to defaults:
year
time_zone
extra => { year => 2004, time_zone => "Australia/Sydney" },
constructor is either an arrayref or a coderef. If an arrayref then the first element is a class name or object, and the second element is a method name (or coderef since Perl allows that sort of thing). The arguments to the call are anything in $p and anything given in the extra option above.
$p
extra
If only a coderef is supplied, then it is called with arguments of $self, $p and extra.
$self
In short:
$self->$coderef( %$p, %{ $self->{extra} } );
The method is expected to return a valid DateTime object, or undef in event of failure, but can conceivably return anything it likes. So long as it's 'true'.
See the main module's section.
Support for this module is provided via the datetime@perl.org email list. See http://lists.perl.org/ for more details.
Alternatively, log them via the CPAN RT system via the web or email:
http://perl.dellah.org/rt/dtbuilder bug-datetime-format-builder@rt.cpan.org
This makes it much easier for me to track things and thus means your problem is less likely to be neglected.
Copyright © Iain Truskett, 2003. All rights reserved.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.000 or, at your option, any later version of Perl 5 you may have available.
The full text of the licences can be found in the Artistic and COPYING files included with this module, or in perlartistic and perlgpl as supplied with Perl 5.8.1 and later.
Iain Truskett <spoon@cpan.org>
datetime@perl.org mailing list.
datetime@perl.org
http://datetime.perl.org/
perl, DateTime, DateTime::Format::Builder
To install DateTime::Format::Builder, copy and paste the appropriate command in to your terminal.
cpanm
cpanm DateTime::Format::Builder
CPAN shell
perl -MCPAN -e shell install DateTime::Format::Builder
For more information on module installation, please visit the detailed CPAN module installation guide.