Time::ZoneInfo(3)

NAME
Time::ZoneInfo - Perl extension for returning a list of Time Zones...

SYNOPSIS
        use Time::ZoneInfo;
        my $zones = Time::ZoneInfo->new();
        foreach my $zone ($zones->zones) {
                # print $zone->zone . ' - ' . $zone->offset . "\n";
                print $zone . "\n";
        }

        if (my $zone = Time::ZoneInfo->current_zone) {
                my ($latitude, $longitude) = $zones->latitude_longitude_sexagesimal($zone);
                print "$zone: ", $zones->country($zone), "  $latitude $longitude\n";
        }

DESCRIPTION
An OO interface to accessing a list of timezones. This is useful if you want to provide an interface for your user to choose one of the available time zones.

Version 0.3.1 also gives the geolocalisation for a time zone.

METHODS

  new
You can specify the zonetab file by passing in zonetab => 'file/location'

  regions
Return an array (or array ref) to the list of regions

  zones ([region])
Return zones (optionally just for one region)

  country (zone)
Return the country associated with the given zone

  current_zone
Return the current zone configured

  latitude_decimal(zone)
Return the latitude for the given zone using decimal notation.

  latitude_sexagesimal(zone)
Return the latitude for the given zone using sexagesimal notation (eg: 51_30'30"N)

  longitude_decimal(zone)
Return the longitude for the given zone using decimal notation.

  longitude_sexagesimal(zone)
Return the longitude for the given zone using sexagesimal notation (eg: 00_07'31"E)

  latitude_longitude_decimal(zone)
Return a list of two elements: the latitude and longitude for the given zone using decimal notation.

  latitude_longitude_sexagesimal(zone)
Return a list of two elements: the latitude and longitude for the given zone using sexagesimal notation (eg: 51_30'30"N and 00_07'31"E)

=

ERRORS
You can read $Time::ZoneInfo::ERROR for an error message at any time.

CONTRIBUTIONS
Thanks to Richard Carver <cpan.org-rnc@thecarverzone.com> for finding issues processing comments.

Pascal "Pixel" Rigaux added geolocalisation

AUTHOR
Scot Penrose, <scott@cpan.org>

SEE ALSO