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

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