1Date::Manip::TZdata(3)User Contributed Perl DocumentationDate::Manip::TZdata(3)
2
3
4

NAME

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

SYNOPSIS

10          use Date::Manip::TZdata;
11
12          $tzd  = new Date::Manip::TZdata($dir);
13

DESCRIPTION

15       This module is not intended for public use. It is used internally by
16       the scripts used to analyze the time zone database and generate the
17       modules for each time zone. The module is included in the distribution
18       solely for the sake of completeness. Currently, no support is offered
19       for this module, and it can (and may) change without notice.
20
21       This module consists of routines for working with the tzdata files
22       obtained from ftp://elsie.nci.nih.gov/pub/ . These files are updated
23       several times a year and are the basis for time zone descriptions for
24       most computer systems.
25
26       At some point, I am interested in making this module a direct interface
27       to the tzdata files, but in the limited amount of time I have to work
28       on perl modules, other modifications to Date::Manip are much higher
29       priority, so I'm not sure when (or if) this will ever happen.
30

ROUTINES

32       new
33              use Date::Manip::TZdata;
34
35              $tzd  = new Date::Manip::TZdata($dir);
36
37           This finds and reads in all the tzdata. If $dir is passed in, it is
38           the directory where a tzdata directory is located. It defaults to
39           the current directory.
40

KNOWN LIMITATIONS

42       Some assumptions and limitations are assumed in the logic of this
43       module.
44
45       When a time change occurs, the time may change backwards or forwards.
46       Time changes rules are listed on a per-year basis.  It is assumed that
47       time changes will not occur so close to the end or start of the year as
48       to cross the year boundary (in other words, the year will not change as
49       a result of the time change).  This is not accounted for, and it is
50       hoped that this situation will never occur.
51
52       Also, because this module is strictly limited to 4 digit positive years
53       (regardless of whether it is wallclock or universal time), and because
54       various parts of the module switch back and forth, valid times for this
55       module are from Jan 2, 0001 to Dec 30, 9999. This ensures that
56       conversions from wallclock to universal or vice versa will never make
57       dates occur in the year 0000 or 10000.
58

KNOWN BUGS

60       None known.
61

BUGS AND QUESTIONS

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

AUTHOR

67       Sullivan Beck (sbeck@cpan.org)
68
69
70
71perl v5.10.1                      2011-12-07            Date::Manip::TZdata(3)
Impressum