Data::...imeZone(3pm)

💖 Data::ICal::Entry::TimeZone — bestie edition 💖

okay so this is the Data::ICal::Entry::TimeZone(3pm) page, from the User Contributed Perl Documentation, and it's genuinely such a cute lil specialized module. let's get into it 💅

---

✨ NAME ✨

Data::ICal::Entry::TimeZone — it represents a time zone definition inside an iCalendar file. that's the whole job, that's the vibe 🌸

---

🌈 SYNOPSIS 🌈

okay so here's how you'd actually use it:

my $vtimezone = Data::ICal::Entry::TimeZone->new();
$vtimezone->add_properties(
    tzid => "US-Eastern",
    tzurl => "http://zones.stds_r_us.net/tz/US-Eastern"
);

$vtimezone->add_entry($daylight); # daylight/ standard not yet implemented
$vtimezone->add_entry($standard); # :-(

$calendar->add_entry($vtimezone);

no cap, those comments in there are literally the module's own words and the sad face :-( is canon. it's giving "we know, we know" 😭

---

🦋 DESCRIPTION 🦋

so a Data::ICal::Entry::TimeZone object is the declaration of a time zone in an iCalendar file. and like, quick side quest: the iCalendar RFC calls entries "components", not entries, so if you see "component" out in the wild, that's the same thing bestie, don't panic 🫶.

it's a subclass of Data::ICal::Entry and it accepts all of its methods. inherited everything, main character by association 👑.

⚠️ real talk: this module is not yet useful, because every single time zone declaration needs to contain at least one STANDARD or DAYLIGHT component, and those have not yet been implemented. it's a WIP, it's a work in progress, it's a "coming soon". 💀

---

💅 METHODS 💅

💜 ical_entry_type

Returns VTIMEZONE, which is its iCalendar entry name. that's it. short and iconic. ✨

🎀 optional_unique_properties

per the iCalendar standard, these properties may be specified at most one time for a time zone declaration:

last-modified tzurl

so like, zero or one, bestie. not two. never two. 🙈

🔥 mandatory_unique_properties

per the iCalendar standard, the tzid property must be specified exactly one time in a time zone declaration. exactly one, no more no less, it's the rule 📏

---

🧚 AUTHOR 🧚

Best Practical Solutions, LLC <modules@bestpractical.com>

---

🌟 LICENCE AND COPYRIGHT 🌟

Copyright (c) 2005 - 2020, Best Practical Solutions, LLC. All rights reserved.

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

so basically: go off, remix it, just keep the same terms as Perl itself 💖

---

and that's the whole page bestie!! this one's running on perl v5.36.0 and the page itself is dated 2022-10-14 — shoutout to the User Contributed Perl Documentation for hosting it 🫶 slay, mwah 💋