NAME

DateTime::Format::Atom - Parse and format Atom datetime strings

VERSION

Version 1.0.0

SYNOPSIS

use DateTime::Format::Atom;

my $f = DateTime::Format::Atom->new();
my $dt = $f->parse_datetime( '2002-07-01T13:50:05Z' );

# 2002-07-01T13:50:05Z
$f->format_datetime($dt);

DESCRIPTION

This module understands the Atom date/time format, an ISO 8601 profile, defined at http://www.ietf.org/rfc/rfc4287.txt

It can be used to parse these formats in order to create the appropriate objects.

All the work is actually done by DateTime::Format::RFC3339.

METHODS

parse_datetime($string)

Given a Atom datetime string, this method will return a new DateTime object.

If given an improperly formatted string, this method will croak.

For a more flexible parser, see DateTime::Format::ISO8601.

format_datetime($datetime)

Given a DateTime object, this methods returns a Atom datetime string.

For simplicity, the datetime will be converted to UTC first.

SEE ALSO

• DateTime

• DateTime::Format::RFC3339

• DateTime::Format::ISO8601

• http://tools.ietf.org/html/rfc3339, "Date and Time on the Internet: Timestamps" =item * http://tools.ietf.org/html/rfc4287, "The Atom Syndication Format" =back

BUGS

Please report any bugs or feature requests to bug-datetime-format-atom at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=DateTime-Format-Atom. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc DateTime::Format::Atom

You can also look for information at:

• Search CPAN

  http://search.cpan.org/dist/DateTime-Format-Atom

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=DateTime-Format-Atom

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/DateTime-Format-Atom

• CPAN Ratings

  http://cpanratings.perl.org/d/DateTime-Format-Atom

AUTHOR

Eric Brine, <ikegami@adaelis.com>

COPYRIGHT & LICENSE

Public domain. No rights reserved.