1Date::Manip::TZdata(3)User Contributed Perl DocumentationDate::Manip::TZdata(3)
2
3
4
6 Date::Manip::TZdata -- Internal module for working with the tzdata
7 files
8
10 use Date::Manip::TZdata;
11
12 $tzd = new Date::Manip::TZdata($dir);
13
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 These files are updated several times a year and are the basis for time
23 zone descriptions for most computer systems.
24
26 new
27 use Date::Manip::TZdata;
28
29 $tzd = new Date::Manip::TZdata($dir);
30
31 This finds and reads in all the tzdata. If $dir is passed in, it is
32 the directory where a tzdata directory is located. It defaults to
33 the current directory.
34
36 Some assumptions and limitations are assumed in the logic of this
37 module.
38
39 When a time change occurs, the time may change backwards or forwards.
40 Time changes rules are listed on a per-year basis. It is assumed that
41 time changes will not occur so close to the end or start of the year as
42 to cross the year boundary (in other words, the year will not change as
43 a result of the time change). This is not accounted for, and it is
44 hoped that this situation will never occur.
45
46 Also, because this module is strictly limited to 4 digit positive years
47 (regardless of whether it is wall clock or universal time), and because
48 various parts of the module switch back and forth, valid times for this
49 module are from Jan 2, 0001 to Dec 30, 9999. This ensures that
50 conversions from wall clock to universal or vice versa will never make
51 dates occur in the year 0000 or 10000.
52
54 None known.
55
57 Please refer to the Date::Manip man page for information on submitting
58 bug reports or questions to the author.
59
61 Sullivan Beck (sbeck@cpan.org)
62
63
64
65perl v5.38.0 2023-07-20 Date::Manip::TZdata(3)