GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  DATETIME::FORMAT::BUILDER::PARSER::REGEX (3)

.ds Aq ’

NAME

DateTime::Format::Builder::Parser::Regex - Regex based date parsing

CONTENTS

VERSION

version 0.81

SYNOPSIS



   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 ) ],
   );



SPECIFICATION

In addition to the common keys, Regex supports:
o <B>regexB> 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.
o <B>paramsB> 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.
o <B>extraB> 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:



    extra => { year => 2004, time_zone => "Australia/Sydney" },



o <B>constructorB> 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.

If only a coderef is supplied, then it is called with arguments of $self, $p and extra.

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’.

SUPPORT

See DateTime::Format::Builder for details.

SEE ALSO

datetime@perl.org mailing list.

http://datetime.perl.org/

perl, DateTime, DateTime::Format::Builder

AUTHORS

o Dave Rolsky <autarch@urth.org>
o Iain Truskett

COPYRIGHT AND LICENSE

This software is Copyright (c) 2013 by Dave Rolsky.

This is free software, licensed under:



  The Artistic License 2.0 (GPL Compatible)



Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 DATETIME::FORMAT::BUILDER::PARSER::REGEX (3) 2013-04-03

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.