.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Date::Manip::TZdata 3"
.TH Date::Manip::TZdata 3 "2021-03-01" "perl v5.26.3" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Date::Manip::TZdata \-\- Internal module for working with the tzdata files
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&   use Date::Manip::TZdata;
\&
\&   $tzd  = new Date::Manip::TZdata($dir);
.Ve
.SH "DESCRIPTION"
.IX Header "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.
.PP
This module consists of routines for working with the tzdata files.
These files are updated several times a year and are the basis for
time zone descriptions for most computer systems.
.SH "ROUTINES"
.IX Header "ROUTINES"
.IP "\fBnew\fR" 4
.IX Item "new"
.Vb 1
\&   use Date::Manip::TZdata;
\&
\&   $tzd  = new Date::Manip::TZdata($dir);
.Ve
.Sp
This finds and reads in all the tzdata. If \f(CW$dir\fR is passed in, it
is the directory where a tzdata directory is located. It defaults to
the current directory.
.SH "KNOWN LIMITATIONS"
.IX Header "KNOWN LIMITATIONS"
Some assumptions and limitations are assumed in the logic of this
module.
.PP
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.
.PP
Also, because this module is strictly limited to 4 digit positive
years (regardless of whether it is wall clock 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 wall clock to universal or vice versa will never
make dates occur in the year 0000 or 10000.
.SH "KNOWN BUGS"
.IX Header "KNOWN BUGS"
None known.
.SH "BUGS AND QUESTIONS"
.IX Header "BUGS AND QUESTIONS"
Please refer to the Date::Manip man page for information on submitting
bug reports or questions to the author.
.SH "AUTHOR"
.IX Header "AUTHOR"
Sullivan Beck (sbeck@cpan.org)