Olson::...iations(3)

📦
version 0.04 · 2 versions
, in fedora 43

✨ NAME ✨

Olson::Abbreviations -globally unique timezones abbreviation handling

okay bestie so this is Olson::Abbreviations, and it lives in the User Contributed Perl Documentation section (that's the man page name, section 3, iykyk 🎀). It's all about timezone abbreviations and whether they're actually unique on this whole planet or just, like, lying to you. 🌍💅

🌸 DESCRIPTION 🌸

This module is your little helper for converting commonly used and often ambiguous olson abbreviations into TZ offset notation. That's the whole vibe. 🕰️✨

🚧 NOT COMPLETE 🚧

no cap, this module is released as 0.01 because it's useful. It is not complete. fr fr.

To be complete in the author's eyes, this module must accept a locale and disambiguate based on that. That's the missing piece.

EST is not ambiguous if you're standing in the US or in Austrailia. This module should handle this properly in the future. 🙈

🦋 SYNOPSIS 🦋

Quick summary of what the module does. ✨

Perhaps a little code snippet. 🎀

use Olson::Abbreviations;

my $oa = Olson::Abbreviations->new({ tz_abbreviation => 'EST' });
            $oa->is_unambigious; # returns 0
            $oa->is_known;       # returns 1
            $oa->get_offset      # dies
...

💖 METHODS 💖

  • get_offset — Returns the offset to UTC. that's it, that's the job 🫶
  • is_unambigious — Returns 0|1 based on if the abbreviation is globally unambigious to the whole planet. literally the whole planet. 🌍
  • is_known — Returns 0|1 based on if the abbreviation is known despite if it is ambigious or not. known is known, bestie 💅

👑 AUTHOR 👑

Evan Carroll, "<me+cpan at evancarroll.com>" — main character energy, we stan 🫶

💀 BUGS 💀

Please report any bugs or feature requests to "bug-olson-abbreviations at rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Olson-Abbreviations>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. 📬✨

like, actual reciprocal notification. the loop closes. iconic.

🌈 SUPPORT 🌈

You can find documentation for this module with the perldoc command.

perldoc Olson::Abbreviations

You can also look for information at:

Copyright 2012 Evan Carroll, all rights reserved.

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

and that's the whole page, bestie — this one came from User Contributed Perl Documentation, it's the Olson::...iations(3) page, built on perl v5.42.0, dated 2025-07-25. go forth and disambiguate responsibly 🦋🌸

📦 where this page comes from