Palm::DateTime(3pm)

💖 Palm::DateTime 💖

okay so bestie, welcome to Palm::DateTime — she lives over in the User Contributed Perl Documentation corner of the manual and she is lowkey iconic. We're talking Palm OS date/time formats. Plural. Several of them. Buckle up 🎀

---

✨ NAME ✨

Palm::DateTime — the module that deals with all the various Palm OS date/time formats 🕰️✨

---

🌸 VERSION 🌸

This doc is describing version 1.400 of Palm::DateTime, released March 14, 2015, as part of Palm version 1.400. Yes she's vintage. Vintage is a vibe. 👑

---

🦋 DESCRIPTION 🦋

So Palm::DateTime exports subroutines — and listen, all of them are exported by default, no cap, you don't even have to ask. They convert between the various Palm OS date/time formats. It's giving translator. It's giving bilingual but make it calendars. 💅

The data types, bestie (know these, fr fr)

• secs — seconds since the system epoch ⏳
• dlptime — Palm OS DlpDateTimeType (raw) 🧃
• datetime — Palm OS DateTimeType (raw) 🧃
• palmtime — decoded date/time, and she's a hashref 🫶

and the palmtime hashref keys? they are literally:

• second → 0-59
• minute → 0-59
• hour → 0-23
• day → 1-31
• month → 1-12
• year → 4 digits

like. the range discipline. the structure. we love to see it 🌈

---

💅 SUBROUTINES 💅

datetime_to_palmtime

$palmtime = datetime_to_palmtime($datetime)

Takes a Palm OS DateTimeType and turns it into a palmtime hashref. And plot twist: on top of the usual keys, your $palmtime will also have a "wday" field. bonus key, bestie, you didn't even ask ✨

dlptime_to_palmtime

$palmtime = dlptime_to_palmtime($dlptime)

Takes a Palm OS DlpDateTimeType and converts it into a palmtime hashref. that's it, that's the job, she does it flawlessly 🎀

dlptime_to_secs

$secs = dlptime_to_secs($dlptime)

Palm OS DlpDateTimeType in, epoch time out. glow-up complete 🌟

palmtime_to_ascii

$string = palmtime_to_secs(\%palmtime)

Converts a palmtime hashref into a "YYYYMMDDhhmmss" string — like 20011116200051 for example. Your %palmtime has to contain all the standard fields though. no skipping keys, that's the rule 🙈

yes bestie, the synopsis really does say palmtime_to_secs there. we don't ask questions, we just report the facts. 💀

palmtime_to_dlptime

$dlptime = palmtime_to_dlptime(\%palmtime)

Takes a palmtime hashref and hands you back a Palm OS DlpDateTimeType. Again: %palmtime must contain all the standard fields. the whole squad, nobody left behind 🫶

palmtime_to_iso8601

$string = palmtime_to_iso8601(\%palmtime)

Converts a palmtime hashref into a "YYYY-MM-DDThh:mm:ssZ" string — e.g. "2001-11-16T20:00:51Z". and yes she's assuming the GMT timezone, that's what the "Z" is doing there, main character energy ⭐

%palmtime must contain all standard fields. (are you sensing a theme? you should be. all the standard fields. always. 💜)

palmtime_to_secs

$secs = palmtime_to_secs(\%palmtime)

palmtime hashref → epoch seconds. %palmtime must contain all the standard fields, because of course it must 🌸

secs_to_dlptime

$dlptime = secs_to_dlptime($secs)

Epoch time in, Palm OS DlpDateTimeType out. the reverse of the earlier one, she's ambidextrous 💅

secs_to_palmtime

$palmtime = secs_to_palmtime($secs)

Epoch seconds → palmtime hashref. full circle, bestie, we've gone full circle 🦋

---

🧚 CONFIGURATION AND ENVIRONMENT 🧚

Palm::DateTime requires no configuration files and no environment variables. nothing to set up. nothing to export. she simply works. as she should. 💅✨

---

🌈 INCOMPATIBILITIES 🌈

None reported. 👑 (flawless behaviour honestly)

---

💀 BUGS AND LIMITATIONS 💀

No bugs have been reported. not one. not a single one. she's pristine, she's unbothered, she's thriving 🌸

---

🫶 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 <http://rt.cpan.org/Public/Bug/Report.html?Queue=Palm>.

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

(go say hi bestie, they're lovely, the repo is right there 🎀)

---

👑 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. slay. legally slay. ✨

---

🔥 DISCLAIMER OF WARRANTY 🔥

okay bestie this part is in ALL CAPS because it MEANS it, so here it is, every word, no cuts:

BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENSE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

like literally the whole thing. no refunds, no warranties, no vibes-based legal recourse. 💀

---

and that's the page, bestie!! 🎀 this manual was rendered by perl v5.34.0 on 2022-06-16, and it's filed under Palm::DateTime(3pm) because that's her whole name and she's not shortening it for anyone. mwah, go convert some timestamps 💖✨🦋