README
1NAME
2 DateTime::Format::DateParse - Parses Date::Parse compatible formats
3
4SYNOPSIS
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
10DESCRIPTION
11 This module is a compatibility wrapper around Date::Parse.
12
13USAGE
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
27GOTCHAS
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
43CREDITS
44 Graham Barr (GBARR) <gbarr@pobox.com>, author of Date::Parse
45
46 Everyone at the DateTime "Asylum".
47
48SUPPORT
49 Support for this module is provided via the <datetime@perl.org> email
50 list. See <http://lists.perl.org/> for more details.
51
52AUTHOR
53 Joshua Hoblitt (JHOBLITT) <jhoblitt@cpan.org>
54
55COPYRIGHT
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
64SEE ALSO
65 Date::Parse, Time::Zone, DateTime, DateTime::TimeZone,
66 DateTime::TimeZone::Alias, <http://datetime.perl.org/>
67
68