Data::I...imeZone(3)

💖 NAME 💖

ok so bestie, <pink>Data::ICal::TimeZone</pink> is literally the timezone plug for Data::ICal — it's giving calendar-girlie energy and it's here to make your .ics files not be a whole mess. 🗓️✨

(it's a Perl module btw, from the User Contributed Perl Documentation corner of the manual, and the page is named <cyan>Data::ICal::TimeZone(3)</cyan> — iykyk 💅)

---

✨ SYNOPSIS ✨

like here's the whole vibe in one little code block, no notes:

use Data::ICal;
use Data::ICal::TimeZone;

my $cal = Data::ICal->new;
my $zone = Data::ICal::TimeZone->new( timezone => 'Europe/London' );
$cal->add_event( $zone->definition );
my $event = Data::ICal::Entry::Event->new;
$event->add_properties(
    summary => 'Go to the pub',
    dtstart => [ '20070316T180000' , { TZID => $zone->timezone } ],
    dtend   => [ '20070316T230000' , { TZID => $zone->timezone } ],
);
$cal->add_event( $event );

ok "Go to the pub" as the example event?? the module authors were fr living their best life 🍓

---

🦋 DESCRIPTION 🦋

Data::ICal::TimeZone hands you a whole mechanism for dropping the Olsen standard timezones into your ical documents, plus it brings along a copy of the Olsen timezone database like a bestie who always has snacks. 🎀

---

💅 METHODS 💅

💜 new( timezone => 'zone_name' )

Returns a timezone object — and that object is gonna be a Data::ICal::TimeZone::Object. 🌸

Returns a false value if it can't locate the timezone you asked for, or if it can't load that timezone's data class. and like, that false value isn't just a boring nothing — it's a Class::ReturnValue object, so you can poke at it and ask for its "error_message". very main character of it, honestly. 😭

💜 zones

Returns the a list of the supported timezones.

(yes bestie, it really do say "Returns the a list" — we keep the facts exactly how they are, no edits, that's the rule 💀)

---

🔥 DIAGNOSTICS 🔥

• No timezone specified — you forgor to pass a "timezone" argument to ->new. it happens to the best of us 🙈
• No such timezone '%s' — the "timezone" you handed to ->new just isn't one this module knows about. not in the group chat. 💀
• Couldn't require Data::ICal::TimeZone::Object::%s: %s — the underlying class didn't compile cleanly. it's giving "syntax error, blocked, reported". 😭

---

👑 AUTHOR 👑

Richard Clamp <richardc@unixbeard.net> — icon behavior, we stan. 🫶

---

🎀 LICENCE AND COPYRIGHT 🎀

Copyright 2007, Richard Clamp. 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.

---

🌈 BUGS 🌈

None currently known, please report any you find to the author.

(impeccable, flawless, no notes, no bugs on the roster ⭐)

---

🧚 VERSION 🧚

The current zone data was generated from tzdata2007g using Vzic 1.3.

---

💖 SEE ALSO 💖

• Data::ICal::TimeZone::Object
• Data::ICal
• http://dialspace.dial.pipex.com/prod/dialspace/town/pipexdsl/s/asbm26/vzic/

---

ok that's the whole page bestie, every flag, every error, every copyright line, untouched and unbothered 💅

perl v5.42.0 · 2025-07-25 — mwah, that's a wrap on this page, go build a calendar and go to the pub 🍓✨🦋