DateTime::Format::W3CDTF (3pm)

  use DateTime::Format::W3CDTF;

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

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

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

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

This \s-1API\s0 is currently experimental and may change in the future.

• new() Returns a new W3CDTF parser object.

• parse_datetime($string) Given a W3CDTF datetime string, this method will return a new \*(C`DateTime\*(C' object. If given an improperly formatted string, this method may die.

• format_datetime($datetime) Given a \*(C`DateTime\*(C' object, this methods returns a W3CDTF datetime string. \s-1NOTE:\s0 As of version 0.4, format_datetime no longer attempts to truncate datetimes without a time component. This is due to the fact that \*(C`DateTime\*(C' doesn't distinguish between a date with no time component, and midnight.

• format_date($datetime) Given a \*(C`DateTime\*(C' object, return a W3CDTF datetime string without the time component.

Support for this module is provided via the [email protected] email list. See http://datetime.perl.org/?MailingList for details.

Please submit bugs to the \s-1CPAN\s0 \s-1RT\s0 system at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=datetime-format-w3cdtf or via email at [email protected].

Dave Rolsky <[email protected]>

This module is maintained by Gregory Todd Williams <[email protected]>. It was originally created by Kellan Elliott-McCrea <[email protected]>.

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

Copyright (c) 2009 David Rolsky. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Copyright (c) 2003 Kellan Elliott-McCrea

Portions of the code in this distribution are derived from other works. Please see the \s-1CREDITS\s0 file for more details.

The full text of the license can be found in the \s-1LICENSE\s0 file included with this module.

[email protected] mailing list

http://datetime.perl.org/