Olson::Abbreviations(3)

NAME
Olson::Abbreviations -globally unique timezones abbreviation handling

DESCRIPTION
This module should help you with converting commonly used and often ambigious olson abbreviations into TZ offset notation.

  NOT COMPLETE
This module is released as 0.01 because it is useful. It is not complete. In order to be complete in the author's eyes this module must accept a locale and disambiguate based on that.

EST is not ambigious if your 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

is_unambigious
    Returns 0|1 based on if the abbreviation is globally unambigious to the whole planet

is_known
    Returns 0|1 based on if the abbreviation is known despite if it is ambigious or not

AUTHOR
Evan Carroll, "<me+cpan at evancarroll.com>"

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.

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

    perldoc Olson::Abbreviations

You can also look for information at:

•   RT: CPAN's request tracker

    <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Olson-Abbreviations>

•   AnnoCPAN: Annotated CPAN documentation

    <http://annocpan.org/dist/Olson-Abbreviations>

•   CPAN Ratings

    <http://cpanratings.perl.org/d/Olson-Abbreviations>

•   Search CPAN

    <http://search.cpan.org/dist/Olson-Abbreviations/>

COPYRIGHT & LICENSE
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.