summaryrefslogtreecommitdiff
path: root/tzfile.5
diff options
context:
space:
mode:
authorStuart Bishop <stuart.bishop@canonical.com>2020-11-02 14:25:46 +1100
committerStuart Bishop <stuart.bishop@canonical.com>2020-11-02 14:25:46 +1100
commita4a62d8d41eea2df3759cbcdbd9100a72e8c28c7 (patch)
tree5264246af4d08afcaf61ce53f0aa12ac58a1ba31 /tzfile.5
parentbc11842827a7379d99ff529674e1084a0a32a245 (diff)
downloadpytz-git-a4a62d8d41eea2df3759cbcdbd9100a72e8c28c7.tar.gz
Squashed 'tz/' changes from 7aec41a1d..d828740bb
9c175ec6c Release 2020d 65f1deaca * tz-link.html: Fix typo b80ed1696 Fix Palestine 2015 fall and 2020 spring efd0231aa Palestine ends DST on 2020-10-24 103e7868c Fail on ZIC_BLOAT_DEFAULT typo 980306471 Improve TZUpdater and Python links ce89cbaa4 Port ‘make rearguard_tarballs’ to macOS 43dda7dbe Cite Tom Scott on Danish time 40e0dc322 Update Danish URLs ab21ad971 Release 2020c dc43ed588 * europe (Hungary): Add more URLs (thanks to Géza Nyáry). 0c8cac40a Put dummy pacificnew into rearguard tarball 27264eae8 * ziguard.awk: Add limitations commentary. 6a244fd41 * europe: Hungary URL comments (thanks to Michael Deckers). d5c1b97cd Fiji observes DST from 2020-12-20 to 2021-01-17 47311d42a Release 2020b 64308c005 * NEWS: Fix Antarctic seasons, Casey change is past 06520a2b4 Tighten up scope wording c5f6ef851 Convert tz-how-to.html to HTML 5 110feebd9 Further update code to match Link line field names 284e877d7 Drop support for zic -y, Rule TYPEs, pacificnew b3cf2ee42 Remove obsolete file systemv d6abc89b3 * antarctica (Antarctica/Casey): Correct 2019-10 transition. 6427fe6c0 Fixes for Casey and Macquarie dd606383a * NEWS: Fix typo (thanks to Philip Paeps). d3bdef36c Yukon’s change is effective 2020-11-01. afc53e03f * tz-link.html: Cite PyPI tzdata (thanks to Paul Ganssle). 2c431bd71 * tz-link.html: Cite Python 3.9 (thanks to Matt Johnson-Pint). abbe4eeee * tz-art.html: Add Mr. Monk (thanks to Arthur David Olson). 241e6df07 Improve heads-up advice cb2d288ae * tz-link.html: Cite TZDIST list. (Thanks to Michael Douglass.) d7451484e Cite Rishi et al in tz-link 3e865829e * asia: Cite Barak 2020 on Israeli DST controversy. a9f132757 Mention Intl.DateTimeFormat 243321439 * README: Add a pointer to tz-how-to.html. 6d25c3e89 date: simplify format compuation dca583ac6 date: redo strftime buffer-exhaustion check 8b238ec54 strftime: conform better to POSIX+ 6e2e87703 Minor editorial improvements for newstrftime.3 ba912ae8b * backzone: More commentary re 1940s Bahrain. 39c661ee1 Update Bahrain as per article in The National 63699ef40 Fix leapseconds comment when EXPIRES_LINE b04741d80 No leap second on 2020-12-31 efbae189b Cite Mirmalek on Martian timekeeping 6ba6f2117 zic now defaults to ‘-b slim’ 08c326dfd Do not install 'posixrules' by default 180f76a2d zic has new ‘-l -’ and ‘-p -’ options c9e377825 * europe: Fix minor comment typos in previous change. ccbd7d2ef Go back to midnight transitions for France etc. 812249354 * NEWS: Fix recent date typo. ddb5717c5 Further fixes to 1891 and 1911 French transitions 1c8ce71c3 French clocks stopped for 9′21″ on 1911-03-11 f8eca4dc2 * europe: Add Hungaricana URLs (thanks to Géza Nyáry). 1d8d276b3 Improve 1890 Hungarian transition. f87ed56da Fix Hungarian transitions 1918-1983 e30fe68d4 Predict Morocco spring-forward after Eid al-Fitr 243ae0709 Fix comment typo re 1900 Spanish decree c6c18a432 More Ruthenia replacement b43b6b46b Mention TimeZoneDB’s CSV and SQL files. 402965e63 Use bold for command and func names in man pages d36f8f5b6 Remove tzsetwall git-subtree-dir: tz git-subtree-split: d828740bbde9367c28fda3c08d26db59f0865162
Diffstat (limited to 'tzfile.5')
-rw-r--r--tzfile.552
1 files changed, 26 insertions, 26 deletions
diff --git a/tzfile.5 b/tzfile.5
index 3f13563..2642978 100644
--- a/tzfile.5
+++ b/tzfile.5
@@ -40,25 +40,25 @@ Fifteen bytes containing zeros reserved for future use.
Six four-byte integer values, in the following order:
.RS
.TP
-.I tzh_ttisutcnt
+.B tzh_ttisutcnt
The number of UT/local indicators stored in the file.
(UT is Universal Time.)
.TP
-.I tzh_ttisstdcnt
+.B tzh_ttisstdcnt
The number of standard/wall indicators stored in the file.
.TP
-.I tzh_leapcnt
+.B tzh_leapcnt
The number of leap seconds for which data entries are stored in the file.
.TP
-.I tzh_timecnt
+.B tzh_timecnt
The number of transition times for which data entries are stored
in the file.
.TP
-.I tzh_typecnt
+.B tzh_typecnt
The number of local time types for which data entries are stored
in the file (must not be zero).
.TP
-.I tzh_charcnt
+.B tzh_charcnt
The number of bytes of time zone abbreviation strings
stored in the file.
.RE
@@ -66,14 +66,14 @@ stored in the file.
The above header is followed by the following fields, whose lengths
depend on the contents of the header:
.IP * 2
-.I tzh_timecnt
+.B tzh_timecnt
four-byte signed integer values sorted in ascending order.
These values are written in network byte order.
Each is used as a transition time (as returned by
.BR time (2))
at which the rules for computing local time change.
.IP *
-.I tzh_timecnt
+.B tzh_timecnt
one-byte unsigned integer values;
each one but the last tells which of the different types of local time types
described in the file is associated with the time period
@@ -83,8 +83,8 @@ and continuing up to but not including the next transition time.
POSIX-style TZ string described below.)
These values serve as indices into the next field.
.IP *
-.I tzh_typecnt
-.I ttinfo
+.B tzh_typecnt
+.B ttinfo
entries, each defined as follows:
.in +.5i
.sp
@@ -99,36 +99,36 @@ struct ttinfo {
.fi
.sp
Each structure is written as a four-byte signed integer value for
-.IR tt_utoff ,
+.BR tt_utoff ,
in network byte order, followed by a one-byte boolean for
-.I tt_isdst
+.B tt_isdst
and a one-byte value for
-.IR tt_desigidx .
+.BR tt_desigidx .
In each structure,
-.I tt_utoff
+.B tt_utoff
gives the number of seconds to be added to UT,
-.I tt_isdst
+.B tt_isdst
tells whether
-.I tm_isdst
+.B tm_isdst
should be set by
.BR localtime (3)
and
-.I tt_desigidx
+.B tt_desigidx
serves as an index into the array of time zone abbreviation bytes
that follow the
-.I ttinfo
+.B ttinfo
structure(s) in the file.
The
-.I tt_utoff
+.B tt_utoff
value is never equal to \-2**31, to let 32-bit clients negate it without
overflow.
Also, in realistic applications
-.I tt_utoff
+.B tt_utoff
is in the range [\-89999, 93599] (i.e., more than \-25 hours and less
than 26 hours); this allows easy support by implementations that
already support the POSIX-required range [\-24:59:59, 25:59:59].
.IP *
-.I tzh_leapcnt
+.B tzh_leapcnt
pairs of four-byte values, written in network byte order;
the first value of each pair gives the nonnegative time
(as returned by
@@ -142,12 +142,12 @@ The pairs of values are sorted in ascending order by time.
Each transition is for one leap second, either positive or negative;
transitions always separated by at least 28 days minus 1 second.
.IP *
-.I tzh_ttisstdcnt
+.B tzh_ttisstdcnt
standard/wall indicators, each stored as a one-byte boolean;
they tell whether the transition times associated with local time types
were specified as standard time or local (wall clock) time.
.IP *
-.I tzh_ttisutcnt
+.B tzh_ttisutcnt
UT/local indicators, each stored as a one-byte boolean;
they tell whether the transition times associated with local time types
were specified as UT or local time.
@@ -173,10 +173,10 @@ The
.BR localtime (3)
function
normally uses the first
-.I ttinfo
+.B ttinfo
structure in the file
if either
-.I tzh_timecnt
+.B tzh_timecnt
is zero or the time argument is less than the first transition time recorded
in the file.
.SS Version 2 format
@@ -235,7 +235,7 @@ This guideline helps obsolescent version 1 readers
agree with current readers about timestamps within the
contiguous subsequence. It also lets writers not
supporting obsolescent readers use a
-.I tzh_timecnt
+.B tzh_timecnt
of zero
in the version 1 data block to save space.
.PP