---
name: "Time::Zone"
section: "3pm"
platform: "linux"
package: "perl-timedate"
version: "2.35-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Time::Zone"
---

# Time::Zone(3pm)

miscellaneous timezone manipulations routines

## NAME

Time::Zone - miscellaneous timezone manipulations routines

## VERSION

version 2.35

## 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

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)](/date/1.md)-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

## NAME

Time::Zone -- miscellaneous timezone manipulations routines

## AUTHORS

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

## AUTHOR

Graham \<gbarr@pobox.com\>

## COPYRIGHT AND LICENSE

This software is copyright (c) 2020 by Graham Barr.

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