# perldoc > Time::Zone

---
type: CommandReference
command: Time::Zone
mode: perldoc
section: ""
source: perldoc
---

## Quick Reference

- `use Time::Zone` — import timezone manipulation routines
- `tz2zone($TZ, $time, $isdst)` — return timezone string from TZ environment variable or given arguments
- `tz_local_offset()` — return local offset from GMT in seconds (cached)
- `tz_offset($TZ)` — return offset from GMT in seconds for a specified timezone
- `tz_name($offset)` — return timezone name based on its offset

## Name

**Time::Zone** — miscellaneous timezone manipulation routines

## Synopsis

perl
use Time::Zone;
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

- `tz2zone()` — parses the TZ environment variable and returns a timezone string suitable for inclusion in `date(1)`-like output. Optionally takes a timezone string, a time, and a is-dst flag.
- `tz_local_offset()` — determines the offset from GMT time in seconds. 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.

## Examples

perl
use Time::Zone;
print tz2zone();                     # current timezone string
print tz2zone('America/New_York');   # given timezone
print tz_local_offset();             # seconds from GMT
## Authors

Graham Barr `<gbarr@pobox.com>`, David Muir Sharnoff `<muir@idiom.com>`, Paul Foley `<paul@ascent.com>`