Palm::DateTime (3)

Leading comments

Automatically generated by Pod::Man 2.28 (Pod::Simple 3.29)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/Palm::DateTime.3pm".)

NAME

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

VERSION

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

DESCRIPTION

Palm::DateTime exports subroutines to convert between various Palm date/time formats. All subroutines are exported by default.

Data types:

 secs     - Seconds since the system epoch
 dlptime  - Palm OS DlpDateTimeType (raw)
 datetime - Palm OS DateTimeType (raw)
 palmtime - Decoded date/time (a hashref)
              KEY     VALUES
              second  0-59
              minute  0-59
              hour    0-23
              day     1-31
              month   1-12
              year    4 digits

SUBROUTINES

datetime_to_palmtime

  $palmtime = datetime_to_palmtime($datetime)

Converts Palm

DateTimeType to a palmtime hashref. In addition to the usual keys, $palmtime will contain a "wday" field.

dlptime_to_palmtime

  $palmtime = dlptime_to_palmtime($dlptime)

Converts Palm

DlpDateTimeType to a palmtime hashref.

dlptime_to_secs

  $secs = dlptime_to_secs($dlptime)

Converts a Palm

DlpDateTimeType to epoch time.

palmtime_to_ascii

  $string = palmtime_to_secs(\%palmtime)

Converts a palmtime hashref to a "YYYYMMDDhhmmss" string (e.g. 20011116200051). %palmtime must contain all standard fields.

palmtime_to_dlptime

  $dlptime = palmtime_to_dlptime(\%palmtime)

Converts a palmtime hashref to a Palm

DlpDateTimeType. %palmtime must contain all standard fields.

palmtime_to_iso8601

  $string = palmtime_to_iso8601(\%palmtime)

Converts a palmtime hashref to a "YYYY-MM-DDThh:mm:ssZ" string (e.g. "2001-11-16T20:00:51Z"). %palmtime must contain all standard fields.

timezone (``Z'') is assumed.

palmtime_to_secs

  $secs = palmtime_to_secs(\%palmtime)

Converts a palmtime hashref to epoch seconds. %palmtime must contain all standard fields.

secs_to_dlptime

  $dlptime = secs_to_dlptime($secs)

Converts epoch time to a Palm

DlpDateTimeType.

secs_to_palmtime

  $palmtime = secs_to_palmtime($secs)

Converts epoch seconds to a palmtime hashref.

CONFIGURATION AND ENVIRONMENT

Palm::DateTime requires no configuration files or environment variables.

INCOMPATIBILITIES

None reported.

BUGS AND LIMITATIONS

No bugs have been reported.

AUTHORS

Alessandro Zummo "<a.zummo AT towertech.it>"

Currently maintained by Christopher J. Madsen "<perl AT cjmweb.net>"

Please report any bugs or feature requests to "<bug-Palm AT rt.cpan.org>" or through the web interface at <rt.cpan.org/Public/Bug/Report.html?Queue=Palm>.

You can follow or contribute to p5-Palm's development at <github.com/madsen/p5-Palm>.

COPYRIGHT AND LICENSE

This software is copyright (c) 2003 by Andrew Arensburger & Alessandro Zummo.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

DISCLAIMER OF WARRANTY

(),