Plucen...ializer(3pm)

💖 Plucene::Document::DateSerializer(3pm) 💖

okay so bestie, you know how Plucene::Document::DateSerializer is a thing? yeah. this is that page. it's the date-handling girlie of the Plucene universe and she is carrying the whole timeline on her back, no cap. 🎀

---

✨ NAME ✨

Plucene::Document::DateSerializer — utility functions for dealing with dates 🦋

---

🌸 SYNOPSIS 🌸

like, here's the vibe in code form:

use Plucene::Document::DateSerializer
my $field = Plucene::Document::Field->Text(
        date => freeze_date(Time::Piece $t)
);
$doc->add($field);

that's it. that's the whole ritual. ✨

---

💜 DESCRIPTION 💜

okay so real talk: dates and times in Plucene should be serialized using the freeze_date function. why? because that's the whole point — it means Plucene::Search::DateFilter can actually filter on them during future searches. it's giving future-proofing. it's giving main character energy. do it this way or your dates are just out here unsearchable and sad. 💅

---

🧚 SUBROUTINES 🧚

🍓 freeze_date

my $string = freeze_date(Time::Piece $t)

this routine is exported by default (yes queen, you get it for free 🫶). it takes a Time::Piece object and turns it into a string in a format that both Plucene and Lucene expect. so like, both sides of the friendship group are happy. iconic. 👑

⭐ thaw_date

my Time::Piece $t = Plucene::Document::DateSerializer::thaw_date($string)

okay so this one is not exported, and also it's not used by the Plucene core. so what's the tea? it's useful for debugging dates, and it simply reverses the freeze_date operation. that's it. it's the undo button. it's the "wait let me check what I actually just did" function. 😭

heads up bestie: since it's not exported, you gotta call it the long way — Plucene::Document::DateSerializer::thaw_date($string). no shortcuts here. 🙈

---

that's the whole page, babe. go freeze some dates and slay. 💖

this was perl v5.36.0, dated 2022-12-04, straight from the User Contributed Perl Documentation. mwah. 💋