| 1 |
NAME |
| 2 |
DateTime::Format::DateParse - Parses Date::Parse compatible formats |
| 3 |
|
| 4 |
SYNOPSIS |
| 5 |
use DateTime::Format::DateParse; |
| 6 |
|
| 7 |
my $dt = DateTime::Format::DateParse->parse_datetime( $date ); |
| 8 |
my $dt = DateTime::Format::DateParse->parse_datetime( $date, $zone ); |
| 9 |
|
| 10 |
DESCRIPTION |
| 11 |
This module is a compatibility wrapper around Date::Parse. |
| 12 |
|
| 13 |
USAGE |
| 14 |
Import Parameters |
| 15 |
This module accepts no arguments to it's "import" method and exports no |
| 16 |
*symbols*. |
| 17 |
|
| 18 |
Methods |
| 19 |
Class Methods |
| 20 |
* parse_datetime($date [, $zone]) |
| 21 |
|
| 22 |
Accepts a Date::Parse compatible $date string and optionally a |
| 23 |
Time::Zone compatible $zone string. |
| 24 |
|
| 25 |
Returns a DateTime object. |
| 26 |
|
| 27 |
GOTCHAS |
| 28 |
* If parse_datetime is called on a $date that doesn't know specify a |
| 29 |
timezone and $zone is not set, then the timezone of the returned |
| 30 |
DateTime object will be set to the "local" timezone. This is |
| 31 |
consistent with the behavior of Date::Parse. |
| 32 |
|
| 33 |
* If parse_datetime is called without a $zone but the $date string |
| 34 |
*does* specify a timezone/offset or if parse_datetime is called with |
| 35 |
a $zone that DateTime::TimeZone does not understand, the returned |
| 36 |
DateTime object will have it's timezone set to a fixed offset from |
| 37 |
UTC. This means that "DST" information is not available and date |
| 38 |
math will not reflect "DST" transitions. This may be resolved for |
| 39 |
true timezones by using the DateTime::TimeZone::Alias module to |
| 40 |
"alias" the Time::Zone timezone to an Olson DB name. This may be |
| 41 |
done automatically in a future release. |
| 42 |
|
| 43 |
CREDITS |
| 44 |
Graham Barr (GBARR) <[email protected]>, author of Date::Parse |
| 45 |
|
| 46 |
Everyone at the DateTime "Asylum". |
| 47 |
|
| 48 |
SUPPORT |
| 49 |
Support for this module is provided via the <[email protected]> email |
| 50 |
list. See <http://lists.perl.org/> for more details. |
| 51 |
|
| 52 |
AUTHOR |
| 53 |
Joshua Hoblitt (JHOBLITT) <[email protected]> |
| 54 |
|
| 55 |
COPYRIGHT |
| 56 |
Copyright (c) 2005-6 Joshua Hoblitt. All rights reserved. This program |
| 57 |
is free software; you can redistribute it and/or modify it under the |
| 58 |
same terms as Perl itself. |
| 59 |
|
| 60 |
The full text of the licenses can be found in the *LICENSE* file |
| 61 |
included with this module, or in perlartistic and perlgpl as supplied |
| 62 |
with Perl 5.8.1 and later. |
| 63 |
|
| 64 |
SEE ALSO |
| 65 |
Date::Parse, Time::Zone, DateTime, DateTime::TimeZone, |
| 66 |
DateTime::TimeZone::Alias, <http://datetime.perl.org/> |
| 67 |
|