Codebase list libdatetime-format-dateparse-perl / HEAD
HEAD

Tree @HEAD (Download .tar.gz)

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/>