Scroll to navigation

DateTime::Format::DateParse(3pm) User Contributed Perl Documentation DateTime::Format::DateParse(3pm)

NAME

DateTime::Format::DateParse - Parses Date::Parse compatible formats

SYNOPSIS

    use DateTime::Format::DateParse;
    my $dt = DateTime::Format::DateParse->parse_datetime( $date );
    my $dt = DateTime::Format::DateParse->parse_datetime( $date, $zone );

DESCRIPTION

This module is a compatibility wrapper around Date::Parse.

USAGE

Import Parameters

This module accepts no arguments to it's "import" method and exports no symbols.

Methods

Class Methods

parse_datetime($date [, $zone])

Accepts a Date::Parse compatible $date string and optionally a Time::Zone compatible $zone string.

Returns a DateTime object.

GOTCHAS

  • If parse_datetime is called on a $date that doesn't know specify a timezone and $zone is not set, then the timezone of the returned DateTime object will be set to the "local" timezone. This is consistent with the behavior of Date::Parse.
  • If parse_datetime is called without a $zone but the $date string does specify a timezone/offset or if parse_datetime is called with a $zone that DateTime::TimeZone does not understand, the returned DateTime object will have it's timezone set to a fixed offset from UTC. This means that "DST" information is not available and date math will not reflect "DST" transitions. This may be resolved for true timezones by using the DateTime::TimeZone::Alias module to "alias" the Time::Zone timezone to an Olson DB name. This may be done automatically in a future release.

CREDITS

Graham Barr (GBARR) <gbarr@pobox.com>, author of Date::Parse

Everyone at the DateTime "Asylum".

SUPPORT

Support for this module is provided via the <datetime@perl.org> email list. See <http://lists.perl.org/> for more details.

AUTHOR

Joshua Hoblitt (JHOBLITT) <jhoblitt@cpan.org>

COPYRIGHT

Copyright (c) 2005-6 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.

SEE ALSO

Date::Parse, Time::Zone, DateTime, DateTime::TimeZone, DateTime::TimeZone::Alias, <http://datetime.perl.org/>

2011-12-14 perl v5.40.0