1DateTime::Format::Atom(U3s)er Contributed Perl DocumentatDiaotneTime::Format::Atom(3)
2
3
4
6 DateTime::Format::Atom - Parse and format Atom datetime strings
7
9 Version 1.2.0
10
12 use DateTime::Format::Atom;
13
14 my $f = DateTime::Format::Atom->new();
15 my $dt = $f->parse_datetime( '2002-07-01T13:50:05Z' );
16
17 # 2002-07-01T13:50:05Z
18 print $f->format_datetime($dt);
19
21 This module understands the Atom date/time format, an ISO 8601 profile,
22 defined at <http://tools.ietf.org/html/rfc4287>
23
24 It can be used to parse these formats in order to create the
25 appropriate objects.
26
27 All the work is actually done by DateTime::Format::RFC3339.
28
30 parse_datetime($string)
31 Given a Atom datetime string, this method will return a new
32 DateTime object.
33
34 If given an improperly formatted string, this method will croak.
35
36 For a more flexible parser, see DateTime::Format::ISO8601.
37
38 format_datetime($datetime)
39 Given a DateTime object, this methods returns a Atom datetime
40 string.
41
42 For simplicity, the datetime will be converted to UTC first.
43
45 • DateTime
46
47 • DateTime::Format::RFC3339
48
49 • DateTime::Format::ISO8601
50
51 • <http://tools.ietf.org/html/rfc3339>, "Date and Time on the
52 Internet: Timestamps"
53
54 • <http://tools.ietf.org/html/rfc4287>, "The Atom Syndication Format"
55
57 Please report any bugs or feature requests to "bug-Datetime-Format-Atom
58 at rt.cpan.org", or through the web interface at
59 <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=DateTime-Format-Atom>.
60 I will be notified, and then you'll automatically be notified of
61 progress on your bug as I make changes.
62
64 You can find documentation for this module with the perldoc command.
65
66 perldoc DateTime::Format::Atom
67
68 You can also look for information at:
69
70 • Search CPAN
71
72 <http://search.cpan.org/dist/DateTime-Format-Atom>
73
74 • RT: CPAN's request tracker
75
76 <http://rt.cpan.org/NoAuth/Bugs.html?Dist=DateTime-Format-Atom>
77
78 • AnnoCPAN: Annotated CPAN documentation
79
80 <http://annocpan.org/dist/DateTime-Format-Atom>
81
82 • CPAN Ratings
83
84 <http://cpanratings.perl.org/d/DateTime-Format-Atom>
85
87 Eric Brine, "<ikegami@adaelis.com>"
88
90 No rights reserved.
91
92 The author has dedicated the work to the Commons by waiving all of his
93 or her rights to the work worldwide under copyright law and all related
94 or neighboring legal rights he or she had in the work, to the extent
95 allowable by law.
96
97 Works under CC0 do not require attribution. When citing the work, you
98 should not imply endorsement by the author.
99
100
101
102perl v5.36.0 2023-01-20 DateTime::Format::Atom(3)