diff --git a/tz-how-to.html b/tz-how-to.html index bf3e86f..e1e28f2 100644 --- a/tz-how-to.html +++ b/tz-how-to.html @@ -17,7 +17,7 @@ td.footnote {text-align: left;}
This page uses the America/Chicago
and
+
This guide uses the America/Chicago
and
Pacific/Honolulu
zones as examples of how to infer
times of day from the tz database
source files. It might be helpful, but not absolutely necessary,
@@ -25,7 +25,10 @@ for the reader to have already downloaded the
latest release of the database and become familiar with the basic layout
of the data files. The format is explained in the “man
page” for the zic compiler, zic.8.txt
, in
-the code
subdirectory.
code
subdirectory.
+Although this guide covers many of the common cases, it is not a
+complete summary of what zic accepts; the man page is the
+authoritative reference.
We’ll begin by talking about the rules for changing between standard and daylight saving time since we’ll need that information when we talk @@ -111,7 +114,8 @@ representable year.
The next column, -
, is reserved; for compatibility with earlier
releases, it always contains a hyphen, which acts as a kind of null value.
Prior to the 2020b release, it was called the TYPE
field, though
-it was never used in the main data. An obsolescent supplementary file used the
+it had not been used in the main data since the 2000e release.
+An obsolescent supplementary file used the
field as a proof-of-concept to allow zic
to apply a given Rule
line only to certain “types” of years within the specified range as
dictated by the output of a separate script, such as: only years which would
@@ -490,21 +494,26 @@ offset, so the local (wall clock) time during this period was GMT −
10:30 + 1:00 = GMT − 9:30.
The FORMAT
column specifies the usual abbreviation of
-the time zone name. It can have one of three forms:
+
”, or “-
”,
-in which case that’s the abbreviation+
”, or “-
”%z
” will be replaced by a numeric time zone
+abbreviation/
’), in which case the first string is the
abbreviation for the standard time name and the second string is the
abbreviation for the daylight saving time name%s
,” in which case
+%s
”, in which case
the “%s
” will be replaced by the text in the
-appropriate Rule’s LETTER
columnLETTER
column, and the resulting
+string should be a time zone abbreviation
The last two make sense only if there’s a named rule in effect.
diff --git a/tz-link.html b/tz-link.html index 92da48f..53e5c3c 100644 --- a/tz-link.html +++ b/tz-link.html @@ -255,7 +255,8 @@ href="https://dev.mysql.com/doc/refman/en/time-zone-support.html">MySQL, Noda Time, and OpenJDK/Oracle JDK. -Sources for the tz
database are
+
Since version 2013a,
+sources for the tz
database have been
UTF-8
text files