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;}

How to Read the tz Database Source Files

by Bill Seymour

-

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.

+the 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:

+the time zone name. It should have one of four forms:

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