1Palm::DateTime(3)     User Contributed Perl Documentation    Palm::DateTime(3)
2
3
4

NAME

6       Palm::DateTime - Deal with various Palm OS date/time formats
7

VERSION

9       This document describes version 1.400 of Palm::DateTime, released March
10       14, 2015 as part of Palm version 1.400.
11

DESCRIPTION

13       Palm::DateTime exports subroutines to convert between various Palm OS
14       date/time formats.  All subroutines are exported by default.
15
16       Data types:
17
18        secs     - Seconds since the system epoch
19        dlptime  - Palm OS DlpDateTimeType (raw)
20        datetime - Palm OS DateTimeType (raw)
21        palmtime - Decoded date/time (a hashref)
22                     KEY     VALUES
23                     second  0-59
24                     minute  0-59
25                     hour    0-23
26                     day     1-31
27                     month   1-12
28                     year    4 digits
29

SUBROUTINES

31   datetime_to_palmtime
32         $palmtime = datetime_to_palmtime($datetime)
33
34       Converts Palm OS DateTimeType to a palmtime hashref.  In addition to
35       the usual keys, $palmtime will contain a "wday" field.
36
37   dlptime_to_palmtime
38         $palmtime = dlptime_to_palmtime($dlptime)
39
40       Converts Palm OS DlpDateTimeType to a palmtime hashref.
41
42   dlptime_to_secs
43         $secs = dlptime_to_secs($dlptime)
44
45       Converts a Palm OS DlpDateTimeType to epoch time.
46
47   palmtime_to_ascii
48         $string = palmtime_to_secs(\%palmtime)
49
50       Converts a palmtime hashref to a "YYYYMMDDhhmmss" string (e.g.
51       20011116200051).  %palmtime must contain all standard fields.
52
53   palmtime_to_dlptime
54         $dlptime = palmtime_to_dlptime(\%palmtime)
55
56       Converts a palmtime hashref to a Palm OS DlpDateTimeType.  %palmtime
57       must contain all standard fields.
58
59   palmtime_to_iso8601
60         $string = palmtime_to_iso8601(\%palmtime)
61
62       Converts a palmtime hashref to a "YYYY-MM-DDThh:mm:ssZ" string (e.g.
63       "2001-11-16T20:00:51Z").  %palmtime must contain all standard fields.
64       GMT timezone ("Z") is assumed.
65
66   palmtime_to_secs
67         $secs = palmtime_to_secs(\%palmtime)
68
69       Converts a palmtime hashref to epoch seconds.  %palmtime must contain
70       all standard fields.
71
72   secs_to_dlptime
73         $dlptime = secs_to_dlptime($secs)
74
75       Converts epoch time to a Palm OS DlpDateTimeType.
76
77   secs_to_palmtime
78         $palmtime = secs_to_palmtime($secs)
79
80       Converts epoch seconds to a palmtime hashref.
81

CONFIGURATION AND ENVIRONMENT

83       Palm::DateTime requires no configuration files or environment
84       variables.
85

INCOMPATIBILITIES

87       None reported.
88

BUGS AND LIMITATIONS

90       No bugs have been reported.
91

AUTHORS

93       Alessandro Zummo "<a.zummo AT towertech.it>"
94
95       Currently maintained by Christopher J. Madsen "<perl AT cjmweb.net>"
96
97       Please report any bugs or feature requests to
98       "<bug-Palm AT rt.cpan.org>" or through the web interface at
99       <http://rt.cpan.org/Public/Bug/Report.html?Queue=Palm>.
100
101       You can follow or contribute to p5-Palm's development at
102       <https://github.com/madsen/p5-Palm>.
103
105       This software is copyright (c) 2003 by Andrew Arensburger & Alessandro
106       Zummo.
107
108       This is free software; you can redistribute it and/or modify it under
109       the same terms as the Perl 5 programming language system itself.
110

DISCLAIMER OF WARRANTY

112       BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
113       FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT
114       WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER
115       PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND,
116       EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
117       WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE
118       ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH
119       YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
120       NECESSARY SERVICING, REPAIR, OR CORRECTION.
121
122       IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
123       WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
124       REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENSE, BE LIABLE
125       TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR
126       CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
127       SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
128       RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
129       FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
130       SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
131       DAMAGES.
132
133
134
135perl v5.36.0                      2023-01-20                 Palm::DateTime(3)
Impressum