---
name: "Time::Timezone"
section: "3pm"
platform: "linux"
package: "perl-time-modules"
version: "2013.0912-13"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Time::Timezone"
---

# Time::Timezone(3pm)

## NAME

Time::Timezone -- miscellaneous timezone manipulations routines

## SYNOPSIS

```
        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);
```

## DESCRIPTION

This is a collection of miscellaneous timezone manipulation routines.

`tz2zone()` parses the TZ environment variable and returns a timezone string suitable for inclusion in date-like output.  It opionally takes a timezone string, a time, and a is-dst flag.

`tz_local_offset()` determins the offset from GMT time in seconds.  It only does the calculation once.

`tz_offset()` determines the offset from GMT in seconds of a specified timezone.

`tz_name()` determines the name of the timezone based on its offset

## AUTHORS

Graham Barr \<bodg@tiuk.ti.com\> David Muir Sharnoff \<muir@idiom.org\> Paul Foley \<paul@ascent.com\>

## LICENSE

David Muir Sharnoff disclaims any copyright and puts his contribution to this module in the public domain.
