Time::Timezone(3pm)

💖 Time::Timezone 💖

okay bestie, so this is the manual page for Time::Timezone (that's the Time::Timezone(3pm) one, a Perl module, a whole vibe) and it's literally just a lil grab-bag of timezone-manipulation routines. no cap, it's giving "utility drawer of your kitchen but make it timezones". let's get into it 🕐✨

---

🌸 NAME 🌸

Time::Timezone — miscellaneous timezone manipulations routines. that's it, that's the whole thing, it's a lil collection of helpers 🫶

---

⭐ SYNOPSIS ⭐

here's how you actually use it, copy-paste girlies:

use Time::Timezone;
print tz2zone();
print tz2zone($ENV{'TZ'});
print tz2zone($ENV{'TZ'}, time());
print tz2zone($ENV{'TZ'}, undef, $isdst);
$offset = tz_local_offset();
$offset = tz_offset($TZ);

like, load the module, call the functions, grab your $offset, brb living your best life 💅

---

🦋 DESCRIPTION 🦋

This is a collection of miscellaneous timezone manipulation routines. (yes bestie, that's genuinely all the intro it gives us, it's a humble icon like that.)

Let's break down the cast of characters, shall we 👑

💜 tz2zone()

okay so tz2zone() parses the TZ environment variable and returns a timezone string suitable for inclusion in date-like output. it optionally takes a timezone string, a time, and a is-dst flag. so it's flexible like that — you can hand it nothing, or you can hand it up to three lil arguments and it'll do its thing ✨

💜 tz_local_offset()

tz_local_offset() determines the offset from GMT time in seconds. and here's the tea: it only does the calculation once. so it's not out here recalculating every single time like an overthinker, it caches the vibe and moves on. efficient queen 👑

💜 tz_offset()

tz_offset() determines the offset from GMT in seconds of a specified timezone. so you give it a timezone — you know, that $TZ from the synopsis — and it gives you the offset back in seconds. clocked 🕰️

💜 tz_name()

tz_name() determines the name of the timezone based on its offset. yes bestie, it's doing the reverse journey: offset in, name out 🌈

---

🎀 AUTHOR 🎀

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

(they made it, they maintain it, send them your love or your bug reports, both are valid 🫶)

---

✨ ORIGINAL AUTHORS ✨

Graham Barr, David Muir Sharnoff, Paul Foley

the OGs!! the founding mothers/fathers of this whole operation, we stan 💖

---

👑 LICENSE AND COPYRIGHT 👑

Copyright (C) 2026 Best Practical Solutions, LLC.

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

so yeah, it's free software, you can redistribute it and/or modify it, and it goes down under the exact same terms as Perl itself. iconic, permissive, no drama 💅

---

ok that's genuinely the whole page bestie, there's no hidden OPTIONS section, no sneaky ENVIRONMENT section, nothing. this module is short and it knows it. main character energy fr fr 🧚

---

and that's a wrap! this page is from perl v5.40.1, dated 2026-02-28, and it's filed under Time::Timezone(3pm). take care of your timezones and your timezones will take care of you 💖✨🌸 bye bestie!! 🦋