NAME

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

SYNOPSIS

  use DateTime::Format::W3CDTF;

  my $f = DateTime::Format::W3CDTF->new;
  my $dt = $f->parse_datetime( '2003-02-15T13:50:05-05:00' );

  # 2003-02-15T13:50:05-05:00
  $f->format_datetime($dt);

DESCRIPTION

This module understands the W3CDTF date/time format, an ISO 8601 profile, defined at http://www.w3.org/TR/NOTE-datetime. This format as the native date format of RSS 1.0.

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

NOTE: W3CDTF does not define a duration format, so this module does not implement the parse_duration(), and format_duration() methods.

METHODS

This API is currently experimental and may change in the future.

• parse_datetime($string)

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

  If given an improperly formatted string, this method may die.

• parse_duration($string)

  This method is NOT supported, and will die if called.

• format_datetime($datetime)

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

• format_duration($duration)

  This method is NOT supported, and will die if called.

SUPPORT

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

AUTHOR

Kellan Elliott-McCrea <kellan@protest.net>

This module was inspired by DateTime::Format::ICal

COPYRIGHT

Copyright (c) 2003 Kellan Elliott-McCrea. 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 license can be found in the LICENSE file included with this module.

SEE ALSO

datetime@perl.org mailing list

http://datetime.perl.org/