14616d0f9Sopenharmony_ciREADME for the tz distribution 24616d0f9Sopenharmony_ci 34616d0f9Sopenharmony_ci"Where do I set the hands of the clock?" -- Les Tremayne as The King 44616d0f9Sopenharmony_ci"Oh that--you can set them any place you want." -- Frank Baxter as The Scientist 54616d0f9Sopenharmony_ci (from the Bell System film "About Time") 64616d0f9Sopenharmony_ci 74616d0f9Sopenharmony_ciThe Time Zone Database (called tz, tzdb or zoneinfo) contains code and 84616d0f9Sopenharmony_cidata that represent the history of local time for many representative 94616d0f9Sopenharmony_cilocations around the globe. It is updated periodically to reflect 104616d0f9Sopenharmony_cichanges made by political bodies to time zone boundaries, UTC offsets, 114616d0f9Sopenharmony_ciand daylight-saving rules. 124616d0f9Sopenharmony_ci 134616d0f9Sopenharmony_ciSee <https://www.iana.org/time-zones/repository/tz-link.html> or the 144616d0f9Sopenharmony_cifile tz-link.html for how to acquire the code and data. 154616d0f9Sopenharmony_ci 164616d0f9Sopenharmony_ciOnce acquired, read the leading comments in the file "Makefile" 174616d0f9Sopenharmony_ciand make any changes needed to make things right for your system, 184616d0f9Sopenharmony_ciespecially when using a platform other than current GNU/Linux. 194616d0f9Sopenharmony_ci 204616d0f9Sopenharmony_ciThen run the following commands, substituting your desired 214616d0f9Sopenharmony_ciinstallation directory for "$HOME/tzdir": 224616d0f9Sopenharmony_ci 234616d0f9Sopenharmony_ci make TOPDIR="$HOME/tzdir" install 244616d0f9Sopenharmony_ci "$HOME/tzdir/usr/bin/zdump" -v America/Los_Angeles 254616d0f9Sopenharmony_ci 264616d0f9Sopenharmony_ciSee the file tz-how-to.html for examples of how to read the data files. 274616d0f9Sopenharmony_ci 284616d0f9Sopenharmony_ciThis database of historical local time information has several goals: 294616d0f9Sopenharmony_ci 304616d0f9Sopenharmony_ci * Provide a compendium of data about the history of civil time that 314616d0f9Sopenharmony_ci is useful even if not 100% accurate. 324616d0f9Sopenharmony_ci 334616d0f9Sopenharmony_ci * Give an idea of the variety of local time rules that have existed 344616d0f9Sopenharmony_ci in the past and thus may be expected in the future. 354616d0f9Sopenharmony_ci 364616d0f9Sopenharmony_ci * Test the generality of the local time rule description system. 374616d0f9Sopenharmony_ci 384616d0f9Sopenharmony_ciThe information in the time zone data files is by no means authoritative; 394616d0f9Sopenharmony_cifixes and enhancements are welcome. Please see the file CONTRIBUTING 404616d0f9Sopenharmony_cifor details. 414616d0f9Sopenharmony_ci 424616d0f9Sopenharmony_ciThanks to these Time Zone Caballeros who've made major contributions to the 434616d0f9Sopenharmony_citime conversion package: Keith Bostic; Bob Devine; Paul Eggert; Robert Elz; 444616d0f9Sopenharmony_ciGuy Harris; Mark Horton; John Mackin; and Bradley White. Thanks also to 454616d0f9Sopenharmony_ciMichael Bloom, Art Neilson, Stephen Prince, John Sovereign, and Frank Wales 464616d0f9Sopenharmony_cifor testing work, and to Gwillim Law for checking local mean time data. 474616d0f9Sopenharmony_ciThanks in particular to Arthur David Olson, the project's founder and first 484616d0f9Sopenharmony_cimaintainer, to whom the time zone community owes the greatest debt of all. 494616d0f9Sopenharmony_ciNone of them are responsible for remaining errors. 504616d0f9Sopenharmony_ci 514616d0f9Sopenharmony_ci----- 524616d0f9Sopenharmony_ci 534616d0f9Sopenharmony_ciThis file is in the public domain, so clarified as of 2009-05-17 by 544616d0f9Sopenharmony_ciArthur David Olson. The other files in this distribution are either 554616d0f9Sopenharmony_cipublic domain or BSD licensed; see the file LICENSE for details. 56