Time::Zone(3) User Contributed Perl Documentation Time::Zone(3)

# [NAME](#NAME)

Time::Zone -- miscellaneous timezone manipulations routines

# [SYNOPSIS](#SYNOPSIS)

```
    use Time::Zone;
    print tz2zone();
    print tz2zone($ENV{'TZ'});
    print tz2zone($ENV{'TZ'}, time());
    my $isdst = 0;
    print tz2zone($ENV{'TZ'}, undef, $isdst);
    my $offset = tz_local_offset();
    my $TZ = "EST";
    $offset = tz_offset($TZ);
```

# [DESCRIPTION](#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**(1)](/man/enterprise-packages/perl-timedate/date.1)-like output. It optionally takes a timezone string, a time, and a is-dst flag.

tz\_local\_offset() determines 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](#AUTHORS)

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

2026-04-02 perl v5.42.2

---

Document: Time::Zone(3pm) from perl-timedate 2.35-r1 (Chainguard OS)
Source: https://github.com/atoomic/perl-TimeDate