DateTime::Format::Builder::Parser::Regex - Regex based date parsing
version 0.83
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
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
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
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
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'.
undef
datetime@perl.org mailing list.
datetime@perl.org
http://datetime.perl.org/
perl, DateTime, DateTime::Format::Builder
Bugs may be submitted at https://github.com/houseabsolute/DateTime-Format-Builder/issues.
I am also usually active on IRC as 'autarch' on irc://irc.perl.org.
irc://irc.perl.org
The source code repository for DateTime-Format-Builder can be found at https://github.com/houseabsolute/DateTime-Format-Builder.
Dave Rolsky <autarch@urth.org>
Iain Truskett <spoon@cpan.org>
This software is Copyright (c) 2020 by Dave Rolsky.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)
The full text of the license can be found in the LICENSE file included with this distribution.
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.