NAME

Astro::App::Satpass2::ParseTime::ISO8601 - Astro::App::Satpass2 minimal ISO-8601 parser

SYNOPSIS

No user-serviceable parts inside.

DETAILS

This class parses ISO-8601 dates. It does not do ordinal days or weeks, but it is rather permissive on punctuation, and permits the convenience dates 'yesterday', 'today', and 'tomorrow'.

This class understands ISO-8601 time zone specifications of the form 'Z', 'UT', 'GMT' and "[+-]\d{1,2}:?\d{,2}", but it knows nothing about shifts for summer time. So "2009/7/1 12:00:00 -5" is 5:00 PM GMT, not 4:00 PM. An attempt to set any other time zone will result in a warning, and the system default zone being used.

As an extension to the ISO-8601 standard, years can be followed by an era specification, which is one of 'AD', 'BC', 'BCE', or 'CE' without regard to case. The era indicator may be separated from the year by white space, and be followed by a non-digit separator character.

Unless the era is specified, years less than 70 will have 2000 added, and years at least equal to 70 but less than 100 will have 1900 added.

If DateTime can be loaded, it will be used to get an epoch from the parsed date. Otherwise Time::Local will be used. Time::Local has its own quirks when it sees a year in the distant past. See its documentation for more information.

METHODS

This class supports no public methods over and above those documented in its superclass Astro::App::Satpass2::ParseTime.

SUPPORT

Support is by the author. Please file bug reports at <https://rt.cpan.org/Public/Dist/Display.html?Name=Astro-App-Satpass2>, <https://github.com/trwyant/perl-Astro-App-Satpass2/issues>, or in electronic mail to the author.

AUTHOR

Thomas R. Wyant, III wyant at cpan dot org

COPYRIGHT AND LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl 5.10.0. For more details, see the full text of the licenses in the directory LICENSES.

This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.