DateTime::Format::ISO8601 - Parses ISO8601 formats
use DateTime::Format::ISO8601; my $dt = DateTime::Format::ISO8601->parse_datetime( $str ); my $dt = DateTime::Format::ISO8601->parse_time( $str ); or my $iso8601 = DateTime::Format::ISO8601->new; my $dt = $iso8601->parse_datetime( $str ); my $dt = $iso8601->parse_time( $str );
Parses almost all ISO8601 date and time formats. ISO8601 time-intervals will be supported in a later release.
This module accepts no arguments to it's import method.
import
new( ... )
Accepts an optional hash.
my $iso8601 = DateTime::Format::ISO8601->new( base_datetime => $dt, cut_off_year => 42, legacy_year => 1, );
base_datetime
A DateTime object that will be used to fill in missing information from incomplete date/time formats.
DateTime
This key is optional.
cut_off_year
A integer representing the cut-off point between interpreting 2-digits years as 19xx or 20xx.
2-digit years < legacy_year will be interpreted as 20xx 2-digit years >= legacy_year will be untreated as 19xx
This key defaults to the value of DefaultCutOffYear.
DefaultCutOffYear
legacy_year
A boolean value controlling if a 2-digit year is interpreted as being in the current century (unless a base_datetime is set) or if cut_off_year should be used to place the year in either 20xx or 19xx.
This key defaults to the value of DefaultLegacyYear.
DefaultLegacyYear
clone
Returns a replica of the given object.
Returns a DateTime object if a base_datetime has been set.
set_base_datetime( object => $object )
Accepts a DateTime object that will be used to fill in missing information from incomplete date/time formats.
Returns a integer representing the cut-off point between interpreting 2-digits years as 19xx or 20xx.
set_cut_off_year( $int )
Accepts a integer representing the cut-off point between interpreting 2-digits years as 19xx or 20xx.
2-digit years < legacy_year will be interpreted as 20xx 2-digit years >= legacy_year will be interpreted as 19xx
Returns a boolean value indicating the 2-digit year handling behavior.
set_legacy_year( $bool )
Accepts a boolean value controlling if a 2-digit year is interpreted as being in the current century (unless a base_datetime is set) or if cut_off_year should be used to place the year in either 20xx or 19xx.
DefaultCutOffYear( $int )
Accepts a integer representing the cut-off point for 2-digit years when calling parse_* as class methods and the default value for cut_off_year when creating objects. If called with no parameters this method will return the default value for cut_off_year.
parse_*
DefaultLegacyYear( $bool )
Accepts a boolean value controlling the legacy year behavior when calling parse_* as class methods and the default value for legacy_year when creating objects. If called with no parameters this method will return the default value for legacy_year.
These may be called as either class or object methods.
parse_datetime
parse_time
Please see the "FORMATS" section.
There are 6 string that can match against date only or time only formats. The parse_datetime method will attempt to match these ambiguous strings against date only formats. If you want to match against the time only formats see the parse_time method.
Expanded ISO8601
These formats are supported with exactly 6 digits for the year. Support for a variable number of digits will be in a later release.
Precision
If a format doesn't include a year all larger time unit up to and including the year are filled in using the current date/time or [if set] the base_datetime object.
Fractional time
There is no limit on the expressed precision.
The supported formats are listed by the section of ISO 8601:2000(E) in which they appear.
YYYYMMDD YYYY-MM-DD
YYYY-MM YYYY YY
YYMMDD YY-MM-DD -YYMM -YY-MM -YY --MMDD --MM-DD --MM ---DD
+[YY]YYYYMMDD +[YY]YYYY-MM-DD +[YY]YYYY-MM +[YY]YYYY +[YY]YY
YYYYDDD YYYY-DDD
YYDDD YY-DDD -DDD
+[YY]YYYYDDD +[YY]YYYY-DDD
YYYYWwwD YYYY-Www-D
YYYYWww YYYY-Www YYWwwD YY-Www-D YYWww YY-Www -YWwwD -Y-Www-D -YWww -Y-Www -WwwD -Www-D -Www -W-D
+[YY]YYYYWwwD +[YY]YYYY-Www-D +[YY]YYYYWww +[YY]YYYY-Www
optionally prefixed with 'T'
hh:mm:ss
hh:mm
fractional (decimal) separator maybe either ',' or '.'
hhmmss,ss hh:mm:ss,ss hhmm,mm hh:mm,mm hh,hh
-mm:ss -mmss,s -mm:ss,s -mm,m --ss,s
hhmmssZ hh:mm:ssZ hhmmZ hh:mmZ hhZ hhmmss.ssZ hh:mm:ss.ssZ
hhmmss[+-]hhmm hh:mm:ss[+-]hh:mm hhmmss[+-]hh hh:mm:ss[+-]hh hhmmss.ss[+-]hhmm hh:mm:ss.ss[+-]hh:mm
YYYYMMDDThhmmss YYYY-MM-DDThh:mm:ss YYYYMMDDThhmmssZ YYYY-MM-DDThh:mm:ssZ YYYYMMDDThhmmss[+-]hhmm YYYY-MM-DDThh:mm:ss[+-]hh:mm YYYYMMDDThhmmss[+-]hh YYYY-MM-DDThh:mm:ss[+-]hh
YYYYMMDDThhmmss.ss YYYY-MM-DDThh:mm:ss.ss YYYYMMDDThhmmss.ss[+-]hhmm YYYY-MM-DDThh:mm:ss.ss[+-]hh:mm
Support for this section is not complete.
YYYYMMDDThhmm YYYY-MM-DDThh:mm YYYYDDDThhmmZ YYYY-DDDThh:mmZ YYYYWwwDThhmm[+-]hhmm YYYY-Www-DThh:mm[+-]hh
Will be supported in a later release.
hhmmss
hhmm hh
-mmss -mm --ss
ISO8601:2000(E) Data elements and interchange formats - information exchange - Representation of dates and times Second edition 2000-12-15
ISO/TC 154 N 362
Iain 'Spoon' Truskett (SPOON) who wrote DateTime::Format::Builder. That has grown into The Vacuum Energy Powered Swiss Army Katana of date and time parsing. This module was inspired by and conceived in honor of Iain's work.
Swiss Army
Tom Phoenix (PHOENIX) and PDX.pm for helping me solve the ISO week conversion bug. Not by fixing the code but motivation me to fix it so I could participate in a game of Zendo.
Zendo
Jonathan Leffler (JOHNL) for reporting a test bug.
Kelly McCauley for a patch to add 8 missing formats.
Alasdair Allan (AALLAN) for complaining about excessive test execution time.
Everyone at the DateTime Asylum.
Asylum
Support for this module is provided via the <datetime@perl.org> email list. See http://lists.perl.org/ for more details.
Joshua Hoblitt <jhoblitt@cpan.org>
Copyright (c) 2003-2005 Joshua Hoblitt. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
The full text of the licenses can be found in the LICENSE file included with this module, or in perlartistic and perlgpl as supplied with Perl 5.8.1 and later.
DateTime, DateTime::Format::Builder, http://datetime.perl.org/
To install DateTime::Format::ISO8601, copy and paste the appropriate command in to your terminal.
cpanm
cpanm DateTime::Format::ISO8601
CPAN shell
perl -MCPAN -e shell install DateTime::Format::ISO8601
For more information on module installation, please visit the detailed CPAN module installation guide.