NAME

       Date::Manip::TZdata -- Internal module for working with the tzdata files

SYNOPSIS

          use Date::Manip::TZdata;

          $tzd  = new Date::Manip::TZdata($dir);

DESCRIPTION

       This module is not intended for public use. It is used internally by the scripts used to
       analyze the time zone database and generate the modules for each time zone. The module is
       included in the distribution solely for the sake of completeness. Currently, no support is
       offered for this module, and it can (and may) change without notice.

       This module consists of routines for working with the tzdata files obtained from
       ftp://ftp.iana.org/tz/ . These files are updated several times a year and are the basis
       for time zone descriptions for most computer systems.

ROUTINES

       new
              use Date::Manip::TZdata;

              $tzd  = new Date::Manip::TZdata($dir);

           This finds and reads in all the tzdata. If $dir is passed in, it is the directory
           where a tzdata directory is located. It defaults to the current directory.

KNOWN LIMITATIONS

       Some assumptions and limitations are assumed in the logic of this module.

       When a time change occurs, the time may change backwards or forwards.  Time changes rules
       are listed on a per-year basis.  It is assumed that time changes will not occur so close
       to the end or start of the year as to cross the year boundary (in other words, the year
       will not change as a result of the time change).  This is not accounted for, and it is
       hoped that this situation will never occur.

       Also, because this module is strictly limited to 4 digit positive years (regardless of
       whether it is wallclock or universal time), and because various parts of the module switch
       back and forth, valid times for this module are from Jan 2, 0001 to Dec 30, 9999. This
       ensures that conversions from wallclock to universal or vice versa will never make dates
       occur in the year 0000 or 10000.

KNOWN BUGS

       None known.

BUGS AND QUESTIONS

       Please refer to the Date::Manip man page for information on submitting bug reports or
       questions to the author.

AUTHOR

       Sullivan Beck (sbeck@cpan.org)