1 1.7 christos README for the tz distribution 2 1.7 christos 3 1.15 christos "Where do I set the hands of the clock?" -- Les Tremayne as The King 4 1.15 christos "Oh that--you can set them any place you want." -- Frank Baxter as The Scientist 5 1.4 jtc (from the Bell System film "About Time") 6 1.4 jtc 7 1.14 christos The Time Zone Database (called tz, tzdb or zoneinfo) contains code and 8 1.8 christos data that represent the history of local time for many representative 9 1.8 christos locations around the globe. It is updated periodically to reflect 10 1.8 christos changes made by political bodies to time zone boundaries, UTC offsets, 11 1.8 christos and daylight-saving rules. 12 1.8 christos 13 1.12 christos See <https://www.iana.org/time-zones/repository/tz-link.html> or the 14 1.17 christos file tz-link.html for how to acquire the code and data. 15 1.5 kleink 16 1.17 christos Once acquired, read the leading comments in the file "Makefile" 17 1.17 christos and make any changes needed to make things right for your system, 18 1.17 christos especially when using a platform other than current GNU/Linux. 19 1.17 christos 20 1.17 christos Then run the following commands, substituting your desired 21 1.17 christos installation directory for "$HOME/tzdir": 22 1.17 christos 23 1.17 christos make TOPDIR="$HOME/tzdir" install 24 1.17 christos "$HOME/tzdir/usr/bin/zdump" -v America/Los_Angeles 25 1.4 jtc 26 1.16 christos See the file tz-how-to.html for examples of how to read the data files. 27 1.16 christos 28 1.14 christos This database of historical local time information has several goals: 29 1.6 mlelstv 30 1.14 christos * Provide a compendium of data about the history of civil time that 31 1.14 christos is useful even if not 100% accurate. 32 1.4 jtc 33 1.14 christos * Give an idea of the variety of local time rules that have existed 34 1.14 christos in the past and thus may be expected in the future. 35 1.4 jtc 36 1.14 christos * Test the generality of the local time rule description system. 37 1.4 jtc 38 1.4 jtc The information in the time zone data files is by no means authoritative; 39 1.9 christos fixes and enhancements are welcome. Please see the file CONTRIBUTING 40 1.9 christos for details. 41 1.4 jtc 42 1.9 christos Thanks to these Time Zone Caballeros who've made major contributions to the 43 1.9 christos time conversion package: Keith Bostic; Bob Devine; Paul Eggert; Robert Elz; 44 1.4 jtc Guy Harris; Mark Horton; John Mackin; and Bradley White. Thanks also to 45 1.4 jtc Michael Bloom, Art Neilson, Stephen Prince, John Sovereign, and Frank Wales 46 1.4 jtc for testing work, and to Gwillim Law for checking local mean time data. 47 1.8 christos Thanks in particular to Arthur David Olson, the project's founder and first 48 1.9 christos maintainer, to whom the time zone community owes the greatest debt of all. 49 1.4 jtc None of them are responsible for remaining errors. 50 1.4 jtc 51 1.10 christos ----- 52 1.10 christos 53 1.10 christos This file is in the public domain, so clarified as of 2009-05-17 by 54 1.10 christos Arthur David Olson. The other files in this distribution are either 55 1.10 christos public domain or BSD licensed; see the file LICENSE for details. 56