NAME

       DateTime::TimeZone::Local::Unix - Determine the local system's time zone on Unix

VERSION

       version 2.18

SYNOPSIS

         my $tz = DateTime::TimeZone->new( name => 'local' );

         my $tz = DateTime::TimeZone::Local->TimeZone();

DESCRIPTION

       This module provides methods for determining the local time zone on a Unix platform.

HOW THE TIME ZONE IS DETERMINED

       This class tries the following methods of determining the local time zone:

       •   $ENV{TZ}

           It checks $ENV{TZ} for a valid time zone name.

       •   /etc/localtime

           If  this  file is a symlink to an Olson database time zone file (usually in /usr/share/zoneinfo) then
           it uses the target file's path name to determine the time zone name. For  example,  if  the  path  is
           /usr/share/zoneinfo/America/Chicago, the time zone is "America/Chicago".

           Some  systems  just  copy  the  relevant file to /etc/localtime instead of making a symlink.  In this
           case, we look in /usr/share/zoneinfo for a file that has the same size and content as  /etc/localtime
           to determine the local time zone.

       •   /etc/timezone

           If this file exists, it is read and its contents are used as a time zone name.

       •   /etc/TIMEZONE

           If  this file exists, it is opened and we look for a line starting like "TZ = ...". If this is found,
           it should indicate a time zone name.

       •   /etc/sysconfig/clock

           If this file exists, it is opened and we look for a line starting like "TIMEZONE = ..."  or  "ZONE  =
           ...". If this is found, it should indicate a time zone name.

       •   /etc/default/init

           If this file exists, it is opened and we look for a line starting like "TZ=...". If this is found, it
           should indicate a time zone name.

SUPPORT

       Bugs may be submitted at <https://github.com/houseabsolute/DateTime-TimeZone/issues>.

       I am also usually active on IRC as 'autarch' on "irc://irc.perl.org".

SOURCE

       The      source      code      repository      for      DateTime-TimeZone     can     be     found     at
       <https://github.com/houseabsolute/DateTime-TimeZone>.

AUTHOR

       Dave Rolsky <autarch@urth.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2018 by Dave Rolsky.

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

       The full text of the license can be found in the LICENSE file included with this distribution.

perl v5.26.1                                       2018-03-24               DateTime::TimeZone::Local::Unix(3pm)