DateTi...:TAI64(3pm)

✨ DateTi...:TAI64(3pm) ✨

okay bestie, welcome to DateTime::Format::Epoch::TAI64 — a lil User Contributed Perl Documentation moment that lives in the 3pm section of your man pages. she converts between DateTime objects and TAI64 values and honestly? she ate. 💅

---

🎀 NAME 🎀

DateTime::Format::Epoch::TAI64 — Convert DateTimes to/from TAI64 values

no cap, that's literally her whole job. 🦋

---

🌸 SYNOPSIS 🌸

here's the vibe, copy-paste coded and everything:

use DateTime::Format::Epoch::TAI64;

my $dt = DateTime::Format::Epoch::TAI64
              ->parse_datetime( '4611686019483526367' );
 # 2003-06-20T19:49:59

DateTime::Format::Epoch::TAI64->format_datetime($dt);
 # 4611686019483526367

my $formatter = DateTime::Format::Epoch::TAI64->new();

$dt = $formatter->parse_datetime( '4611686019483526367' );
 # 2003-06-20T19:49:59

$formatter->format_datetime($dt);
 # 4611686019483526367

my $str_frmt = DateTime::Format::Epoch::TAI64->new(
                                              format => 'string' );

$dt = $str_frmt->parse_datetime( "\x40\0\0\0\x3e\xf3\x69\x6a" );
 # 2003-06-20T19:49:59

$str_frmt->format_datetime($dt);
 # "\x40\0\0\0\x3e\xf3\x69\x6a"

see how she does the exact same thing in class-method form and in formatter-object form? versatile queen 👑

---

💖 DESCRIPTION 💖

so this module can convert a DateTime object — or literally any object that can be converted to a DateTime object, she's not picky — to a TAI64 value. 🌈

and the TAI64 timescale? bestie. she covers the entire expected lifespan of the universe. at least, if you expect the universe to be closed. iconic range, fr fr. 🔥

---

✨ METHODS ✨

most of the methods are the same as those in DateTime::Format::Epoch. the only difference is the constructor. that's it. that's the plot twist. 💀

• new( [format => 'string'] ) — constructor of the formatter/parser object. if the optional format parameter is set to 'string', TAI64 values will be expected to be 8 byte strings. that's the whole deal 🫶

---

🫶 SUPPORT 🫶

need backup? support for this module is provided via the datetime@perl.org email list. see http://lists.perl.org/ for more details. the group chat is always open 💌

---

👑 AUTHOR 👑

Eugene van der Pijll <pijll@gmx.net>

---

💜 COPYRIGHT 💜

Copyright (c) 2003, 2004 Eugene van der Pijll. All rights reserved.

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

(legal bestie said what she said, and we respect her 🎀)

---

🌟 SEE ALSO 🌟

• DateTime
• datetime@perl.org mailing list
• http://cr.yp.to/time.html

---

lowkey reminder: go read DateTime too, she's the main character this module is orbiting around 🌸

---

and that's the whole page, bestie — sourced from perl v5.34.0, dated 2022-06-13, in the DateTi...:TAI64(3pm) era. stay converting, stay slaying 💅✨🦋