tz-link.htm

   1 <!DOCTYPE html
   2         PUBLIC "-//W3C//DTD HTML 4.01//EN"
   3         "http://www.w3.org/TR/html4/strict.dtd">
   4 <html>
   5 <head profile="http://dublincore.org/documents/2008/08/04/dc-html/">
   6 <title>Sources for time zone and daylight saving time data</title>
   7 <link rel="schema.DC" href="http://purl.org/DC/elements/1.1/">
   8 <meta http-equiv="Content-type" content='text/html; charset="UTF-8"'>
   9 <meta name="DC.Title"
  10  content="Sources for time zone and daylight saving time data">
  11 <meta name="DC.Creator" content="Eggert, Paul">
  12 <meta name="DC.Contributor" content="Olson, Arthur David">
  13 <meta name="DC.Date" content="2016-06-14">
  14 <meta name="DC.Description"
  15  content="Sources of information about time zones and daylight saving time">
  16 <meta name="DC.Identifier"
  17  content="http://www.iana.org/time-zones/repository/tz-link.htm">
  18 <meta name="Keywords"
  19  content="database,daylight saving,DST,time zone,timezone,tz,zoneinfo">
  20 </head>
  21 <body>
  22 <h1>Sources for time zone and daylight saving time data</h1>
  23 <p>
  24 Time zone and daylight saving rules are controlled by individual
  25 governments. They are sometimes changed with little notice, and their
  26 histories and planned futures are often recorded only fitfully. Here
  27 is a summary of attempts to organize and record relevant data in this
  28 area.
  29 </p>
  30 <h2>The <code><abbr title="time zone">tz</abbr></code> database</h2>
  31 <p>
  32 The <a href="https://en.wikipedia.org/wiki/Public_domain">public-domain</a>
  33 time zone database contains code and data
  34 that represent the history of local time
  35 for many representative locations around the globe.
  36 It is updated periodically to reflect changes made by political bodies
  37 to <a href="https://en.wikipedia.org/wiki/Time_zone">time zone</a>
  38 boundaries and
  39 <a href="https://en.wikipedia.org/wiki/Daylight_saving_time">daylight-saving</a>
  40 rules.
  41 This database (often called <code>zoneinfo</code> or
  42 <code><abbr>tz</abbr></code>)
  43 is used by several implementations,
  44 including
  45 <a href="http://www.gnu.org/software/libc/">the
  46 <abbr title="GNU's Not Unix">GNU</abbr>
  47 C Library</a> (used in
  48 <a href="https://en.wikipedia.org/wiki/Linux"><abbr>GNU</abbr>/Linux</a>),
  49 <a href="https://www.android.com">Android</a>,
  50 <a href="https://developer.mozilla.org/en-US/docs/Mozilla/B2G_OS">B2G
  51 <abbr title="Operating System">OS</abbr></a>,
  52 <a href="https://www.freebsd.org">Free<abbr
  53 title="Berkeley Software Distribution">BSD</abbr></a>,
  54 <a href="http://netbsd.org">Net<abbr>BSD</abbr></a>,
  55 <a href="http://www.openbsd.org">Open<abbr>BSD</abbr></a>,
  56 <a href="http://www.chromium.org/chromium-os">Chromium OS</a>,
  57 <a href="https://cygwin.com">Cygwin</a>,
  58 <a href="http://www.delorie.com/djgpp/"><abbr
  59 title="DJ's GNU Programming Platform">DJGPP</abbr></a>,
  60 <a href="https://en.wikipedia.org/wiki/MINIX">MINIX</a>,
  61 <a href="https://en.wikipedia.org/wiki/WebOS"><abbr
  62 title="Web Operating System">webOS</abbr></a>,
  63 <a href="http://ibm.com/aix"><abbr
  64 title="Advanced Interactive eXecutive">AIX</abbr></a>,
  65 <a href="https://en.wikipedia.org/wiki/BlackBerry_10">BlackBerry 10</a>,
  66 <a href="http://www.apple.com/ios/"><abbr
  67 title="iPhone OS">iOS</abbr></a>,
  68 <a href="http://windows.microsoft.com">Microsoft Windows</a>,
  69 <a href="http://www.hp.com/go/openvms/">Open<abbr
  70 title="Virtual Memory System">VMS</abbr></a>,
  71 <a href="https://www.oracle.com/database/index.html">Oracle Database</a>,
  72 <a href="http://oracle.com/solaris">Oracle Solaris</a>, and
  73 <a href="http://www.apple.com/osx/"><abbr title="Operating System Ten">OS
  74 X</abbr></a>.</p>
  75 <p>
  76 Each location in the database represents a region where all
  77 clocks keeping local time have agreed since 1970.
  78 Locations are identified by continent or ocean and then by the name of
  79 the location, which is typically the largest city within the region.
  80 For example, <code>America/New_York</code>
  81 represents most of the <abbr title="United States">US</abbr> eastern time zone;
  82 <code>America/Phoenix</code> represents most of Arizona, which
  83 uses mountain time without daylight saving time (<abbr
  84 title="daylight saving time">DST</abbr>);
  85 <code>America/Detroit</code> represents most of Michigan, which uses
  86 eastern time but with different <abbr>DST</abbr> rules in 1975;
  87 and other entries represent smaller regions like Starke County,
  88 Indiana, which switched from central to eastern time in 1991
  89 and switched back in 2006.
  90 To use the database on an extended <a
  91 href="https://en.wikipedia.org/wiki/POSIX"><abbr
  92 title="Portable Operating System Interface">POSIX</abbr></a>
  93 implementation set the <code><abbr>TZ</abbr></code>
  94 environment variable to the location's full name,
  95 e.g., <code><abbr>TZ</abbr>="America/New_York"</code>.</p>
  96 <p>
  97 Associated with each region is a history of offsets from
  98 <a href="https://en.wikipedia.org/wiki/Universal_Time">Universal
  99 Time</a> (<abbr>UT</abbr>), which is <a
 100 href="https://en.wikipedia.org/wiki/Greenwich_Mean_Time">Greenwich Mean
 101 Time</a> (<abbr>GMT</abbr>) with days beginning at midnight;
 102 for time stamps after 1960 this is more precisely <a
 103 href="https://en.wikipedia.org/wiki/Coordinated_Universal_Time">Coordinated
 104 Universal Time</a> (<abbr>UTC</abbr>).
 105 The database also records when daylight saving time was in use,
 106 along with alphabetic time zone abbreviations such as <abbr>EST</abbr>
 107 for Eastern Standard Time in the <abbr>US</abbr>.</p>
 108 <p>
 109 In the <code><abbr>tz</abbr></code> database's
 110 <a href="ftp://ftp.iana.org/tz/releases/"><abbr
 111 title="File Transfer Protocol">FTP</abbr> releases</a>
 112 the code is in the file <code>tzcode<var>C</var>.tar.gz</code>,
 113 where <code><var>C</var></code> is the code's version;
 114 similarly, the data entries are in <code>tzdata<var>D</var>.tar.gz</code>,
 115 where <code><var>D</var></code> is the data's version.
 116 Since 1996, each version has been a four-digit year followed by
 117 lower-case letter (<samp>a</samp> through <samp>z</samp>,
 118 then <samp>za</samp> through <samp>zz</samp>, then <samp>zza</samp>
 119 through <samp>zzz</samp>, and so on).
 120 Convenience links to
 121 the <a href="ftp://ftp.iana.org/tz/tzcode-latest.tar.gz">latest
 122 code</a> and
 123 <a href="ftp://ftp.iana.org/tz/tzdata-latest.tar.gz">latest data</a> revisions
 124 are also available.
 125 The following <a
 126 href="https://en.wikipedia.org/wiki/Unix_shell">shell</a> commands download
 127 these files to a <abbr>GNU</abbr>/Linux or similar host;
 128 see the downloaded
 129 <code>README</code> file for what to do next.</p>
 130 <pre style="margin-left: 2em"><code>mkdir tz
 131 cd tz
 132 <a href="http://www.gnu.org/software/wget/">wget</a> --retr-symlinks 'ftp://ftp.iana.org/tz/tz*-latest.tar.gz'
 133 <a href="http://www.gnu.org/software/gzip/">gzip</a> -dc tzcode-latest.tar.gz | <a href="http://www.gnu.org/software/tar/">tar</a> -xf -
 134 gzip -dc tzdata-latest.tar.gz | tar -xf -
 135 </code></pre>
 136 <p>
 137 The code and data files can also be obtained from the
 138 <a href="http://www.iana.org/time-zones">Time Zone Database website</a>
 139 of the <a href="http://www.iana.org">Internet Assigned Numbers
 140 Authority (IANA)</a>.
 141 An <a href="https://github.com/eggert/tz">unofficial development
 142 repository</a> of the code and data is available
 143 in <a href="http://git-scm.com">Git</a> form
 144 from <a href="https://github.com">GitHub</a>; be careful, as this
 145 repository is less well tested and probably contains more errors.
 146 <p>
 147 The code lets you compile the <code><abbr>tz</abbr></code> source files into
 148 machine-readable binary files, one for each location. It also lets
 149 you read a <code><abbr>tz</abbr></code> binary file and interpret time stamps for that
 150 location.</p>
 151 <h2>Changes to the <code><abbr>tz</abbr></code> database</h2>
 152 <p>
 153 The <code><abbr>tz</abbr></code> code and data
 154 are by no means authoritative. If you find errors, please
 155 send changes to the <a href="mailto:tz@iana.org">time zone
 156 mailing list</a>. You can also <a
 157 href="http://news.gmane.org/gmane.comp.time.tz">browse recent
 158 messages</a> sent to the mailing list, <a
 159 href="https://mm.icann.org/mailman/listinfo/tz">subscribe</a> to it,
 160 and browse the <a
 161 href="http://mm.icann.org/pipermail/tz/">archive of old
 162 messages</a>.</p>
 163 <p>
 164 If your government plans to change its time zone boundaries or
 165 daylight saving rules, let the mailing list know well in advance. With
 166 less than a year's notice there is a good chance that some
 167 computer-based clocks will operate incorrectly after the change, due
 168 to delays in propagating updates to software and data. The shorter
 169 the notice, the more likely clock problems will arise.
 170 </p>
 171 <p>Sources for the <code><abbr>tz</abbr></code> database are
 172 <a href="https://en.wikipedia.org/wiki/UTF-8"><abbr
 173 title="Unicode Transformation Format 8-bit">UTF-8</abbr></a>
 174 <a href="https://en.wikipedia.org/wiki/Text_file">text files</a>
 175 with lines terminated by <a href="https://en.wikipedia.org/wiki/Newline"><abbr
 176 title="linefeed">LF</abbr></a>,
 177 which can be modified by common text editors such
 178 as <a href="https://www.gnu.org/software/emacs/">GNU Emacs</a>,
 179 <a href="https://wiki.gnome.org/Apps/Gedit">gedit</a>, and
 180 <a href="http://www.vim.org">vim</a>. One
 181 editor has a package to simplify editing further:</p>
 182 <ul>
 183 <li><a href="https://packagecontrol.io/packages/zoneinfo">Sublime
 184 zoneinfo</a> is a <a href="http://www.sublimetext.com">Sublime
 185 Text</a> package for syntax highlighting <code><abbr>tz</abbr></code>
 186 source files.</li>
 187 </ul>
 188 <p>
 189 For further information about updates, please see
 190 <a href="https://tools.ietf.org/html/rfc6557">Procedures for
 191 Maintaining the Time Zone Database</a> (Internet <abbr
 192 title="Request For Comments">RFC</abbr> 6557).</p>
 193 <h2>Commentary on the <code><abbr>tz</abbr></code> database</h2>
 194 <ul>
 195 <li>The article
 196 <a href="https://en.wikipedia.org/wiki/Tz_database">tz database</a> is
 197 an encyclopedic summary.</li>
 198 <li><a href="tz-how-to.html">How to Read the
 199 tz Database Source Files</a> explains the <code><abbr>tz</abbr></code>
 200 database format.</li>
 201 <li><a
 202 href="http://codeofmatt.com/2016/04/23/on-the-timing-of-time-zone-changes/">On
 203 the Timing of Time Zone Changes</a> gives examples of problems caused
 204 by inadequate notice by governments of time zone and daylight saving
 205 rule changes.</li>
 206 <li><a
 207 href="http://blog.jonudell.net/2009/10/23/a-literary-appreciation-of-the-olsonzoneinfotz-database/">A
 208 literary appreciation of the Olson/Zoneinfo/tz database</a> comments on the
 209 database's style.</li>
 210 </ul>
 211 <h2>Web sites using recent versions of the <code><abbr>tz</abbr></code> database</h2>
 212 <p>
 213 These are listed roughly in ascending order of complexity and fanciness.
 214 </p>
 215 <ul>
 216 <li><a href="http://time.is">Time.is</a> shows locations'
 217 time and zones in a simple format.</li>
 218 <li><a href="https://www.timejones.com">TimeJones.com</a> is a simple
 219 time zone converter.</li>
 220 <li><a
 221 href="http://twiki.org/cgi-bin/xtra/tzdatepick.html">Date and Time Gateway</a>
 222 lets you see the <code><abbr>TZ</abbr></code> values directly.</li>
 223 <li><a
 224 href="http://www.convertit.com/Go/ConvertIt/World_Time/Current_Time.ASP">Current
 225 Time in 1000 Places</a> uses descriptions of the values.</li>
 226 <li><a href="http://www.timezoneconverter.com/cgi-bin/tzc.tzc">Time Zone
 227 Converter</a>
 228 uses a pulldown menu.</li>
 229 <li><a href="http://home.kpn.nl/vanadovv/time/TZworld.html">Complete
 230 timezone information for all countries</a> displays tables of DST rules.
 231 <li><a href="http://www.timeanddate.com/worldclock/">The World Clock &ndash;
 232 Worldwide</a> lets you sort zone names and convert times.</li>
 233 <li><a href="http://www.zeitverschiebung.net/en/">Time Difference</a>
 234 calculates the current time difference between locations.</li>
 235 <li><a href="http://www.wx-now.com">Weather Now</a> lists the weather too.</li>
 236 <li><a href="http://www.thetimenow.com">The Time Now</a> also lists weather.</li>
 237 <li><a href="https://worldtime.io">worldtime.io</a>
 238 also contains data about time zone boundaries; it supports queries via place
 239 names and shows location maps.</li>
 240 </ul>
 241 <h2>Network protocols for <code><abbr>tz</abbr></code> data</h2>
 242 <ul>
 243 <li>The <a href="http://www.ietf.org">Internet Engineering Task Force</a>'s
 244 <a href="https://datatracker.ietf.org/wg/tzdist/charter/">Time Zone Data
 245 Distribution Service (tzdist) working group</a> defined <a
 246 href="https://tools.ietf.org/html/rfc7808">TZDIST</a>
 247 (Internet <abbr>RFC</abbr> 7808), a time zone data distribution service,
 248 along with a <a href="https://tools.ietf.org/html/rfc7809">calendar access
 249 protocol for transferring time zone data by reference</a>
 250 (Internet <abbr>RFC</abbr> 7809). This work was based
 251 on the iCalendar and CalConnect efforts described below.</li>
 252 <li>The <a href="https://tools.ietf.org/html/rfc5545">
 253 Internet Calendaring and Scheduling Core Object Specification
 254 (iCalendar)</a> (Internet <abbr>RFC</abbr> 5445)
 255 covers time zone
 256 data; see its VTIMEZONE calendar component.
 257 The iCalendar format requires specialized parsers and generators; a
 258 variant <a href="https://tools.ietf.org/html/rfc6321">xCal</a>
 259 (Internet <abbr>RFC</abbr> 6321) uses
 260 <a href="http://www.w3.org/XML/"><abbr
 261 title="Extensible Markup Language">XML</abbr></a> format, and a variant
 262 <a href="https://tools.ietf.org/html/rfc7265">jCal</a>
 263 (Internet <abbr>RFC</abbr> 7265)
 264 uses <a href="http://www.json.org"><abbr
 265 title="JavaScript Object Notation">JSON</abbr></a> format.
 266 <a href="https://www.calconnect.org">CalConnect, The Calendaring and Scheduling
 267 Consortium</a> is promoting further work in this area. <a
 268 href="http://calconnect.org/publications/icalendartimezoneproblemsandrecommendationsv1.0.pdf">iCalendar
 269 TIMEZONE Problems and Recommendations</a> offers guidelines and
 270 recommendations for the use of VTIMEZONE and <code><abbr>tz</abbr></code>.</li>
 271 <li>The <a
 272 href="http://calconnect.org/publications/timezoneregistryandservicerecommendationsv1.0.pdf">Timezone
 273 Registry and Service Recommendations</a> of CalConnect's
 274 <a href="https://www.calconnect.org/about/technical-committees/tc-timezone">TIMEZONE
 275 Technical Committee</a> discusses a
 276 strategy for defining and deploying a time zone
 277 registration process that would establish unique names for each
 278 version of each <code><abbr>tz</abbr></code> zone, along with a polygonal
 279 representation of the geographical area corresponding to the
 280 zone.</li>
 281 <li>The <a
 282 href="http://lists.w3.org/Archives/Public/www-rdf-calendar/">www-rdf-calendar</a>
 283 list discusses <a
 284 href="http://www.w3.org/RDF/"><abbr
 285 title="Resource Description Framework">RDF</abbr></a>-based calendar
 286 and group scheduling systems, and has a <a
 287 href="http://www.w3.org/2002/12/cal/#tzd">workspace on time zone
 288 data</a> converted from <code><abbr>tz</abbr></code>.</li>
 289 </ul>
 290 <h2>Other <code><abbr>tz</abbr></code> compilers</h2>
 291 <ul>
 292 <li><a href="https://sourceforge.net/projects/vzic/">Vzic</a> is a <a
 293 href="https://en.wikipedia.org/wiki/C_%28programming_language%29">C</a>
 294 program that compiles
 295 <code><abbr>tz</abbr></code> source into iCalendar-compatible VTIMEZONE files.
 296 Vzic is freely
 297 available under the <a
 298 href="http://www.gnu.org/copyleft/gpl.html"><abbr>GNU</abbr>
 299 General Public License (<abbr
 300 title="General Public License">GPL</abbr>)</a>.</li>
 301 <li><a href="https://sourceforge.net/projects/tzical/">tziCal &ndash; tz
 302 database conversion utility</a> is like Vzic, except for the <a
 303 href="https://www.microsoft.com/net">.NET framework</a>
 304 and with a <abbr>BSD</abbr>-style license.</li>
 305 <li><a
 306 href="http://search.cpan.org/dist/DateTime-TimeZone/">DateTime::TimeZone</a>
 307 contains a script <code>parse_olson</code> that compiles
 308 <code><abbr>tz</abbr></code> source into <a href="https://www.perl.org">Perl</a>
 309 modules. It is part of the Perl <a
 310 href="http://datetime.perl.org">DateTime Project</a>, which is freely
 311 available under both the <abbr>GPL</abbr> and the Perl Artistic
 312 License. DateTime::TimeZone also contains a script
 313 <code>tests_from_zdump</code> that generates test cases for each clock
 314 transition in the <code><abbr>tz</abbr></code> database.</li>
 315 <li>The <a href="https://howardhinnant.github.io/date/tz.html">Time Zone
 316 Database Parser</a> is a
 317 <a href="https://en.wikipedia.org/wiki/C%2B%2B">C++</a> parser and
 318 runtime library. It is freely available under the
 319 <a href="http://creativecommons.org/licenses/by/4.0/">Creative Commons
 320 Attribution 4.0 International Public License</a>.</li>
 321 <li><a href="http://site.icu-project.org">International Components for
 322 Unicode (<abbr>ICU</abbr>)</a> contains C/C++ and <a
 323 href="https://en.wikipedia.org/wiki/Java_%28programming_language%29">Java</a>
 324 libraries for internationalization that
 325 has a compiler from <code><abbr>tz</abbr></code> source
 326 and from <abbr title="Common Locale Data Repository">CLDR</abbr> data
 327 (mentioned below)
 328 into an <abbr>ICU</abbr>-specific format.
 329 <abbr>ICU</abbr> is freely available under a
 330 <abbr>BSD</abbr>-style license.</li>
 331 <li>The <a href="https://github.com/lau/tzdata">Tzdata</a> package for
 332 the <a href="http://elixir-lang.org">Elixir</a> language downloads
 333 and compiles tz source and exposes <abbr
 334 title="Application Program Interface">API</abbr>s for use. It is
 335 freely available under the <abbr
 336 title="Massachusetts Institute of Technology">MIT</abbr> license.</li>
 337 <li>The <a
 338 href="http://www.oracle.com/technetwork/java/javase/tzupdater-readme-136440.html">TZUpdater
 339 tool</a> compiles <code><abbr>tz</abbr></code> source into the format used by
 340 Oracle Java.</li>
 341 <li><a href="http://www.joda.org/joda-time/">Joda-Time &ndash; Java date
 342 and time <abbr>API</abbr></a> contains a class
 343 <code>org.joda.time.tz.ZoneInfoCompiler</code> that compiles
 344 <code><abbr>tz</abbr></code> source into a Joda-specific binary format. Joda Time
 345 is freely available under a <abbr>BSD</abbr>-style license.</li>
 346 <li><a href="http://nodatime.org">Noda Time &ndash; Date and
 347 time <abbr>API</abbr> for .NET</a>
 348 and <a href="http://www.babiej.demon.nl/Tz4Net/main.htm">TZ4Net</a>
 349 are similar to Joda Time, but for the .NET framework instead of
 350 Java. They are freely available under the
 351 <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License</a>
 352 and a <abbr>BSD</abbr>-style license, respectively.</li>
 353 <li><a href="https://en.wikipedia.org/wiki/JavaScript">JavaScript</a>-based
 354 compilers and libraries include:
 355 <ul>
 356 <li><a href="http://momentjs.com/timezone/">Moment Timezone</a> is a
 357 plugin for the <a href="http://momentjs.com">Moment.js</a> date
 358 manipulation library. It is freely available under the <abbr>MIT</abbr>
 359 license.</li>
 360 <li><a href="https://github.com/mde/timezone-js">TimezoneJS.Date</a>'s
 361 <abbr>API</abbr> is upward compatible with standard JavaScript
 362 Dates. It is freely available under the Apache License.</li>
 363 <li><a href="https://github.com/sproutsocial/walltime-js">Walltime-js</a>
 364 translates <abbr>UT</abbr> to local time. It is freely available under
 365 the <abbr>MIT</abbr> license.</li>
 366 </ul>
 367 <li><a href="http://pytz.sourceforge.net">pytz &ndash; World Timezone
 368 Definitions for Python</a> compiles <code><abbr>tz</abbr></code> source into
 369 <a href="https://www.python.org">Python</a>.
 370 It is freely available under a <abbr>BSD</abbr>-style license.</li>
 371 <li><a href="http://tzinfo.github.io">TZInfo &ndash;
 372 Ruby Timezone Library</a>
 373 compiles <code><abbr>tz</abbr></code> source into
 374 <a href="https://www.ruby-lang.org/en/">Ruby</a>.
 375 It is freely available under the <abbr>MIT</abbr> license.</li>
 376 <li>The <a href="http://www.squeaksource.com/Chronos/">Chronos Date/Time
 377 Library</a> is
 378 a <a href="https://en.wikipedia.org/wiki/Smalltalk">Smalltalk</a> class
 379 library that compiles <code><abbr>tz</abbr></code> source into a time
 380 zone repository whose format
 381 is either proprietary or an <abbr>XML</abbr>-encoded
 382 representation.</li>
 383 <li><a href="http://tcl.tk">Tcl</a>
 384 contains a developer-oriented parser that compiles <code><abbr>tz</abbr></code>
 385 source into text files, along with a runtime that can read those
 386 files. Tcl is freely available under a <abbr>BSD</abbr>-style
 387 license.</li>
 388 </ul>
 389 <h2>Other <code><abbr>tz</abbr></code> binary file readers</h2>
 390 <ul>
 391 <li>The <a
 392 href="http://www.gnu.org/software/libc/"><abbr>GNU</abbr> C
 393 Library</a>
 394 has an independent, thread-safe implementation of
 395 a <code><abbr>tz</abbr></code> binary file reader.
 396 This library is freely available under the
 397 <a href="http://www.gnu.org/copyleft/lesser.html">
 398 <abbr>GNU</abbr> Lesser General Public License
 399 (<abbr title="Lesser General Public License">LGPL</abbr>)</a>,
 400 and is widely used in <abbr>GNU</abbr>/Linux systems.</li>
 401 <li><a href="https://www.gnome.org">GNOME</a>'s Glib has
 402 a <code><abbr>tz</abbr></code> binary file reader written in C that
 403 creates a <code>GTimeZone</code> object representing sets
 404 of <abbr>UT</abbr> offsets.
 405 It is freely available under the <abbr>LGPL</abbr>.</li>
 406 <li>The
 407 <a href="https://github.com/bloomberg/bde/wiki">BDE Standard Library</a>'s
 408 <code>baltzo::TimeZoneUtil</code> component contains a C++
 409 implementation of a binary file reader. It is freely available under
 410 the Apache License.</li>
 411 <li><a href="https://github.com/google/cctz">CCTZ</a> is a simple C++
 412 library that translates between UTC and civil time and can read binary
 413 files. It is freely available under the Apache License.</li>
 414 <li><a href="http://bmsi.com/java/#TZ">ZoneInfo.java</a>
 415 is a <code><abbr>tz</abbr></code> binary file reader written in Java.
 416 It is freely available under the <abbr>LGPL</abbr>.</li>
 417 <li><a href="https://github.com/bigeasy/timezone">Timezone</a> is a
 418 JavaScript library that supports date arithmetic that is time zone
 419 aware. It is freely available under the <abbr>MIT</abbr> license.</li>
 420 <li>Tcl, mentioned above, also contains a
 421 <code><abbr>tz</abbr></code> binary file reader.</li>
 422 <li><a href="http://search.cpan.org/perldoc?DateTime::TimeZone::Tzfile">
 423 DateTime::TimeZone::Tzfile</a>
 424 is a <code><abbr>tz</abbr></code> binary file reader written in Perl.
 425 It is freely available under the same terms as Perl
 426 (dual <abbr>GPL</abbr> and Artistic license).</li>
 427 <li>The
 428 public-domain <a href="https://github.com/dbaron/tz.js">tz.js</a>
 429 library contains a Python tool that
 430 converts <code><abbr>tz</abbr></code> binary data into
 431 <abbr>JSON</abbr>-format data suitable for use
 432 in its JavaScript library for time zone conversion. Dates before 1970
 433 are not supported.</li>
 434 <li>The <a
 435 href="http://hackage.haskell.org/package/timezone-olson">timezone-olson</a>
 436 package contains <a href="https://www.haskell.org">Haskell</a> code that
 437 parses and uses <code><abbr>tz</abbr></code> binary data. It is freely
 438 available under a <abbr>BSD</abbr>-style license.</li>
 439 </ul>
 440 <h2>Other <code><abbr>tz</abbr></code>-based time zone software</h2>
 441 <ul>
 442 <li><a href="https://foxclocks.org">FoxClocks</a>
 443 is an extension for <a href="https://www.google.com/chrome/">Google
 444 Chrome</a> and for <a
 445 href="https://developer.mozilla.org/en-US/docs/Mozilla/Tech/Toolkit_API">Mozilla
 446 Toolkit</a> applications like <a
 447 href="https://www.mozilla.org/en-US/firefox/new/">Firefox</a> and <a
 448 href="https://www.mozilla.org/en-US/thunderbird/">Thunderbird</a>.
 449 It displays multiple clocks in the application window, and has a mapping
 450 interface to <a href="https://www.google.com/earth/">Google Earth</a>.
 451 It is freely available under the <abbr>GPL</abbr>.</li>
 452 <li><a href="https://golang.org">Go programming language</a>
 453 implementations contain a copy of a 32-bit subset of a recent
 454 <code><abbr>tz</abbr></code> database in a
 455 Go-specific format.</li>
 456 <li><a
 457 href="http://users.skynet.be/Peter.Verthez/projects/intclock/">International
 458 clock (intclock)</a> is a clock that displays multiple time zones on
 459 <abbr>GNU</abbr>/Linux and similar systems. It is freely available
 460 under the <abbr>GPL</abbr>.</li>
 461 <li>Microsoft Windows 8.1
 462 and later has <code><abbr>tz</abbr></code> data and <abbr>CLDR</abbr>
 463 data (mentioned below) used by
 464 <a href="https://en.wikipedia.org/wiki/Windows_Runtime">Windows Runtime</a>
 465 classes such as <a
 466 href="https://msdn.microsoft.com/en-us/library/windows/apps/windows.globalization.datetimeformatting.datetimeformatter.aspx"><code>DateTimeFormatter</code></a>.
 467 <a
 468 href="https://blogs.msdn.microsoft.com/bclteam/2007/06/07/exploring-windows-time-zones-with-system-timezoneinfo-josh-free/">Exploring
 469 Windows Time Zones with <code>System.TimeZoneInfo</code></a> describes
 470 the older, proprietary method of Microsoft Windows 2000 and later,
 471 which stores time zone data in the
 472 <a href="https://en.wikipedia.org/wiki/Windows_Registry">Windows Registry</a>. The
 473 <a
 474 href="http://www.unicode.org/cldr/charts/latest/supplemental/zone_tzid.html">Zone &rarr;
 475 Tzid table</a> or <a
 476 href="http://unicode.org/repos/cldr/trunk/common/supplemental/windowsZones.xml"><abbr>XML</abbr>
 477 file</a> of the <abbr>CLDR</abbr> data maps proprietary zone IDs
 478 to <code><abbr>tz</abbr></code> names.
 479 <li><a
 480 href="https://www.oracle.com/java/index.html">Oracle
 481 Java</a> contains a copy of a subset of a recent
 482 <code><abbr>tz</abbr></code> database in a
 483 Java-specific format.</li>
 484 <li><a href="https://kimmo.suominen.com/sw/timezone/">Time Zone</a> is
 485 a <a href="https://wordpress.org">WordPress</a> plugin. It is freely
 486 available under a <abbr>BSD</abbr>-style license.</li>
 487 <li><a href="http://www.relativedata.com/time-zone-master">Time Zone
 488 Master</a> is a Microsoft Windows clock program that can automatically
 489 download, compile and use the <code>tzdata<var>D</var>.tar.gz</code>
 490 files as they are released. The Basic version is free.</li>
 491 <li><a
 492 href="http://veladg.com/velaterra.html">VelaTerra</a> is
 493 an <abbr>OS X</abbr> program. Its developers
 494 <a href="http://veladg.com/tzoffer.html">offer free
 495 licenses</a> to <code><abbr>tz</abbr></code> contributors.</li>
 496 </ul>
 497 <h2>Other time zone databases</h2>
 498 <ul>
 499 <li><a href="http://www.astro.com/atlas">Time-zone Atlas</a>
 500 is Astrodienst's Web version of Shanks and Pottenger's
 501 time zone history atlases published in both <a
 502 href="http://astrocom.com/astrology-products/software/acs-atlas-software">computer</a>
 503 and book form (<a
 504 href="http://www.astrocom.com/astrology/books/american-atlas">one volume
 505 for the <abbr>US</abbr></a>, and <a
 506 href="http://www.astrocom.com/astrology/books/international-atlas">one for
 507 other locations</a>) by <a
 508 href="http://astrocom.com">Astro Computing Services</a>.
 509 These atlases are extensive but unreliable, as Shanks appears to have
 510 guessed many <abbr>UT</abbr> offsets and transitions. The atlases cite no
 511 sources and do not indicate which entries are guesswork.</li>
 512 <li><a href="https://en.wikipedia.org/wiki/HP-UX">HP-UX</a> has a database in
 513 its own <code>tztab</code>(4) format.</li>
 514 <li>Microsoft Windows has proprietary data mentioned above.</li>
 515 <li><a href="http://www.worldtimeserver.com">World Time Server</a>
 516 is another time zone database.</li>
 517 <li><a href="http://tycho.usno.navy.mil/tzones.html">World Time Zones</a>
 518 contains data from the Time Service Department of the
 519 <abbr>US</abbr> Naval Observatory.</li>
 520 <li>The <a href="http://www.iata.org/publications/Pages/ssim.aspx">Standard
 521 Schedules Information Manual</a> of the
 522 International Air Transport Association
 523 gives current time zone rules for airports served by commercial aviation.</li>
 524 </ul>
 525 <h2>Maps</h2>
 526 <ul>
 527 <li>The <a href="https://www.cia.gov/index.html">United States Central
 528 Intelligence Agency (<abbr
 529 title="Central Intelligence Agency">CIA</abbr>)</a> publishes a <a
 530 href="https://www.cia.gov/library/publications/the-world-factbook/graphics/ref_maps/physical/pdf/standard_time_zones_of_the_world.pdf">time
 531 zone map</a>; the
 532 <a
 533 href="http://www.lib.utexas.edu/maps/world.html">Perry&ndash;Casta&ntilde;eda
 534 Library Map Collection</a>
 535 of the University of Texas at Austin has copies of
 536 recent editions.
 537 The pictorial quality is good,
 538 but the maps do not indicate summer time,
 539 and parts of the data are a few years out of date.</li>
 540 <li><a href="http://www.worldtimezone.com">Current time around the world
 541 and standard time zones map of the world</a>
 542 has several fancy time zone maps; it covers Russia particularly well.
 543 The maps' pictorial quality is not quite as good as the
 544 <abbr>CIA</abbr>'s
 545 but the maps are more up to date.</li>
 546 <li><a
 547 href="http://blog.poormansmath.net/how-much-is-time-wrong-around-the-world/">How
 548 much is time wrong around the world?</a> maps the difference between
 549 mean solar and standard time, highlighting areas such as western China
 550 where the two differ greatly. It's a bit out of date, unfortunately.</li>
 551 </ul>
 552 <h2>Time zone boundaries</h2>
 553 <ul>
 554 <li><a href="http://efele.net/maps/tz/"><abbr>TZ</abbr> timezones
 555 maps</a> contains <a
 556 href="https://en.wikipedia.org/wiki/Shapefile">shapefiles</a> of
 557 sets of <code><abbr>tz</abbr></code> regions.</li>
 558 <li>The <a href="https://github.com/bradfitz/latlong">latlong package</a>
 559 maps geographical coordinates to a <code><abbr>tz</abbr></code> region.
 560 It is written in Go and is freely available under the Apache License.</li>
 561 <li><a href="https://derickrethans.nl/what-time-is-it.html">What Time
 562 is It Here?</a> applies <a href="https://www.mongodb.com">MongoDB</a>
 563 geospatial query operators to shapefiles' data.</li>
 564 <li><a href="http://statoids.com/statoids.html">Administrative
 565 Divisions of Countries ("Statoids")</a> contains lists of
 566 political subdivision data related to time zones.</li>
 567 <li><a href="http://home.kpn.nl/vanadovv/time/Multizones.html">Time
 568 zone boundaries for multizone countries</a> summarizes legal
 569 boundaries between time zones within countries.</li>
 570 <li>Manifold.net's <a
 571 href="http://manifold.net/info/freestuff.shtml">Free Stuff for
 572 Manifold System Users</a> includes a Manifold-format map of
 573 world time zone boundaries distributed under the
 574 <abbr>GPL</abbr>.</li>
 575 <li>The GeoCommunity lists several commercial sources for <a
 576 href="http://spatialnews.geocomm.com/features/timezones/">International
 577 Time Zones and Time Zone Data</a>.</li>
 578 <li>A ship within the <a
 579 href="https://en.wikipedia.org/wiki/Territorial_waters">territorial
 580 waters</a> of any nation uses that nation's time. In international
 581 waters, time zone boundaries are meridians 15&deg; apart, except that
 582 <abbr>UTC</abbr>&minus;12 and <abbr>UTC</abbr>+12 are each 7.5&deg;
 583 wide and are separated by
 584 the 180&deg; meridian (not by the International Date Line, which is
 585 for land and territorial waters only). A captain can change ship's
 586 clocks any time after entering a new time zone; midnight changes are
 587 common.</li>
 588 </ul>
 589 <h2>Civil time concepts and history</h2>
 590 <ul>
 591 <li><a href="http://www.nist.gov/pml/general/time/index.cfm">A
 592 Walk through Time</a>
 593 surveys the evolution of timekeeping.</li>
 594 <li><a href="http://www.webexhibits.org/daylightsaving/">About Daylight
 595 Saving Time &ndash; History, rationale, laws &amp; dates</a>
 596 is an overall history of <abbr>DST</abbr>.</li>
 597 <li><a href="https://www.w3.org/TR/timezone/">Working with Time Zones</a>
 598 contains guidelines and best practices for software applications that
 599 deal with civil time.</li>
 600 <li><a href="http://energy.ca.gov/daylightsaving.html">Saving Time,
 601 Saving Energy</a> discusses a primary justification for <abbr>DST</abbr>.</li>
 602 <li><a href="http://seizethedaylight.com/dst/">A Brief
 603 History of Daylight Saving Time</a> summarizes some of the contentious
 604 history of <abbr>DST</abbr>.</li>
 605 <li><a href="http://www.staff.science.uu.nl/~gent0113/idl/idl.htm">A History of
 606 the International Date Line</a> tells the story of the most important
 607 time zone boundary.</li>
 608 <li><a href="http://statoids.com/tconcept.html">Basic Time
 609 Zone Concepts</a> discusses terminological issues behind time zones.</li>
 610 </ul>
 611 <h2>National histories of legal time</h2>
 612 <dl>
 613 <dt>Australia</dt>
 614 <dd>The Parliamentary Library has commissioned a <a
 615 href="http://www.aph.gov.au/binaries/library/pubs/rp/2009-10/10rp10.pdf">research
 616 paper on daylight saving time in Australia</a>.
 617 The Bureau of Meteorology publishes a list of <a
 618 href="http://www.bom.gov.au/climate/averages/tables/dst_times.shtml">Implementation
 619 Dates of Daylight Savings Time within Australia</a>.</dd>
 620 <dt>Belgium</dt>
 621 <dd>The Royal Observatory of Belgium maintains a table of <a
 622 href="http://www.astro.oma.be/GENERAL/INFO/nli001a.html"
 623 hreflang="nl">time in Belgium (in Dutch)</a>.</dd>
 624 <dt>Brazil</dt>
 625 <dd>The Time Service Department of the National Observatory
 626 records <a href="http://pcdsh01.on.br/DecHV.html"
 627 hreflang="pt-BR">Brazil's daylight saving time decrees (in
 628 Portuguese)</a>.</dd>
 629 <dt>Canada</dt>
 630 <dd>National Research Council Canada publishes current
 631 and some older information about <a
 632 href="http://www.nrc-cnrc.gc.ca/eng/services/time/time_zones.html">time
 633 zones &amp; daylight saving time</a>.</dd>
 634 <dt>Chile</dt>
 635 <dd>The Hydrographic and Oceanographic Service of the Chilean Navy publishes a
 636 <a href="http://www.horaoficial.cl/historia_hora.html" hreflang="es">history of
 637 Chile's official time (in Spanish)</a>.</dd>
 638 <dt>Germany</dt>
 639 <dd>The National Institute for Science and Technology maintains the <a
 640 href="http://www.ptb.de/cms/en/fachabteilungen/abt4/fb-44/ag-441/realisation-of-legal-time-in-germany.html">Realisation
 641 of Legal Time in Germany</a>.</dd>
 642 <dt>Israel</dt>
 643 <dd>The Interior Ministry periodically issues <a
 644 href="ftp://ftp.cs.huji.ac.il/pub/tz/announcements"
 645 hreflang="he">announcements (in Hebrew)</a>.</dd>
 646 <dt>Mexico</dt>
 647 <dd>The Investigation and Analysis Service of the Mexican Library of
 648 Congress has published a <a
 649 href="http://www.diputados.gob.mx/bibliot/publica/inveyana/polisoc/horver/index.htm"
 650 hreflang="es">history of Mexican local time (in Spanish)</a>.</dd>
 651 <dt>Malaysia</dt>
 652 <dd>See Singapore below.</dd>
 653 <dt>Netherlands</dt>
 654 <dd><a href="http://www.staff.science.uu.nl/~gent0113/wettijd/wettijd.htm"
 655 hreflang="nl">Legal time in the Netherlands (in Dutch)</a>
 656 covers the history of local time in the Netherlands from ancient times.</dd>
 657 <dt>New Zealand</dt>
 658 <dd>The Department of Internal Affairs maintains a brief <a
 659 href="http://www.dia.govt.nz/Daylight-Saving-History">History of
 660 Daylight Saving</a>. The privately-maintained <a
 661 href="http://astrologyschool.com/nztime.html">History of New Zealand
 662 time</a> has more details.</dd>
 663 <dt>Singapore</dt>
 664 <dd><a
 665 href="http://www.math.nus.edu.sg/aslaksen/teaching/timezone.html">Why
 666 is Singapore in the "Wrong" Time Zone?</a> details the
 667 history of legal time in Singapore and Malaysia.</dd>
 668 <dt>United Kingdom</dt>
 669 <dd><a
 670 href="https://www.polyomino.org.uk/british-time/">History of
 671 legal time in Britain</a> discusses in detail the country
 672 with perhaps the best-documented history of clock adjustments.
 673 The National Physical Laboratory also maintains an <a
 674 href="http://www.npl.co.uk/educate-explore/what-is-time/archive-of-summer-time-dates-1916-2006">Archive
 675 of Summer time dates</a>.</dd>
 676 <dt>United States</dt>
 677 <dd>The Department of Transportation's <a
 678 href="https://www.transportation.gov/regulations/recent-time-zone-proceedings">Recent
 679 Time Zone Proceedings</a> lists changes to time zone boundaries.</dd>
 680 </dl>
 681 <h2>Precision timekeeping</h2>
 682 <ul>
 683 <li><a
 684 href="http://literature.agilent.com/litweb/pdf/5965-7984E.pdf">The
 685 Science of Timekeeping</a> is a thorough introduction
 686 to the theory and practice of precision timekeeping.</li>
 687 <li><a href="http://www.ntp.org"><abbr
 688 title="Network Time Protocol">NTP</abbr>: The Network
 689 Time Protocol</a>
 690 discusses how to synchronize clocks of
 691 Internet hosts.</li>
 692 <li>The <a href="http://www.nist.gov/el/isd/ieee/ieee1588.cfm">Precision
 693 Time Protocol</a> (<abbr
 694 title="Institute of Electrical and Electronics Engineers">IEEE</abbr> 1588)
 695 can achieve submicrosecond clock accuracy on a local area network.</li>
 696 <li><a
 697 href="https://tools.ietf.org/html/rfc4833">Timezone
 698 Options for <abbr title="Dynamic Host Configuration Protocol">DHCP</abbr></a>
 699 (Internet <abbr>RFC</abbr> 4833)
 700 specifies a <a
 701 href="https://en.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol"><abbr>DHCP</abbr></a>
 702 option for a server to configure
 703 a client's time zone and daylight saving settings automatically.</li>
 704 <li><a href="http://gauss.gge.unb.ca/GMT.UT.and.the.RGO.html">A Few Facts
 705 Concerning <abbr>GMT</abbr>, <abbr>UT</abbr>, and
 706 the <abbr title="Royal Greenwich Observatory">RGO</abbr></a>
 707 answers questions like "What is the
 708 difference between <abbr>GMT</abbr> and <abbr>UTC</abbr>?"</li>
 709 <li><a
 710 href="http://www.cv.nrao.edu/~rfisher/Ephemerides/times.html">Astronomical
 711 Times</a> explains more abstruse astronomical time scales like
 712 <abbr title="Terrestrial Dynamic Time">TDT</abbr>,
 713 <abbr title="Geocentric Coordinate Time">TCG</abbr>, and
 714 <abbr title="Barycentric Dynamic Time">TDB</abbr>.
 715 <a href="http://www.ucolick.org/~sla/leapsecs/timescales.html">Time
 716 Scales</a> goes into more detail, particularly for historical variants.</li>
 717 <li>The <a href="http://iau.org"><abbr
 718 title="International Astronomical Union">IAU</abbr></a>'s <a
 719 href="http://www.iausofa.org"><abbr
 720 title="Standards Of Fundamental Astronomy">SOFA</abbr></a>
 721 collection contains C and <a
 722 href="https://en.wikipedia.org/wiki/Fortran">Fortran</a>
 723 code for converting among time scales like
 724 <abbr title="International Atomic Time">TAI</abbr>,
 725 <abbr>TDB</abbr>, <abbr>TDT</abbr> and
 726 <abbr>UTC</abbr>.</li>
 727 <li><a href="http://solarsystem.nasa.gov/basics/bsf2-3.php">Basics of
 728 Space Flight &ndash; Reference Systems &ndash; Time Conventions</a>
 729 briefly explains interplanetary space flight timekeeping.</li>
 730 <li><a
 731 href="http://www.giss.nasa.gov/tools/mars24/help/notes.html">Technical
 732 Notes on Mars Solar Time as Adopted by the Mars24 Sunclock</a> briefly
 733 describes Mars Coordinated Time (<abbr
 734 title="Mars Coordinated Time">MTC</abbr>) and the
 735 diverse local time
 736 scales used by each landed mission on Mars.</li>
 737 <li><a href="http://leapsecond.com">LeapSecond.com</a> is
 738 dedicated not only to leap seconds but to precise time and frequency
 739 in general. It covers the state of the art in amateur timekeeping, and
 740 how the art has progressed over the past few decades.</li>
 741 <li><a
 742 href="https://www.iers.org/IERS/EN/Publications/Bulletins/bulletins.html"><abbr
 743 title="International Earth Rotation and Reference Systems Service">IERS</abbr>
 744 Bulletins</a> contains official publications of the International
 745 Earth Rotation and Reference Systems Service, which decides
 746 when leap seconds occur.</li>
 747 <li>The <a
 748 href="https://pairlist6.pair.net/mailman/listinfo/leapsecs">Leap
 749 Second Discussion List</a> covers <a
 750 href="http://gauss.gge.unb.ca/papers.pdf/gpsworld.november99.pdf">McCarthy
 751 and Klepczynski's proposal to discontinue leap seconds</a>,
 752 discussed further in
 753 <a href="http://www.cl.cam.ac.uk/~mgk25/time/metrologia-leapsecond.pdf">The
 754 leap second: its history and possible future</a>.
 755 <a href="http://www.ucolick.org/~sla/leapsecs/"><abbr>UTC</abbr>
 756 might be redefined
 757 without Leap Seconds</a> gives pointers on this
 758 contentious issue.</li>
 759 </ul>
 760 <h2>Time notation</h2>
 761 <ul>
 762 <li>The <a href="http://cldr.unicode.org">Unicode Common Locale Data
 763 Repository (<abbr>CLDR</abbr>) Project</a> has localizations for time
 764 zone names, abbreviations, identifiers, and formats. For example, it
 765 contains French translations for "Eastern European Summer Time",
 766 "<abbr title="Eastern European Summer Time">EEST</abbr>", and
 767 "Bucharest". Its
 768 <a href="http://unicode.org/cldr/charts/by_type/index.html">by-type
 769 charts</a> show these values for many locales. Data values are available in
 770 both <abbr title="Locale Data Markup Language">LDML</abbr>
 771 (an <abbr>XML</abbr> format) and <abbr>JSON</abbr>.
 772 <li>
 773 <a href="http://www.cl.cam.ac.uk/~mgk25/iso-time.html">A summary of
 774 the international standard date and time notation</a> is a good
 775 summary of
 776 <a
 777 href="http://www.iso.org/iso/catalogue_detail?csnumber=40874"><abbr
 778 title="International Organization for Standardization">ISO</abbr>
 779 8601:2004 &ndash; Data elements and interchange formats &ndash; Information
 780 interchange &ndash; Representation of dates and times</a>.</li>
 781 <li>
 782 <a href="https://www.w3.org/TR/xmlschema-2/#dateTime"><abbr>XML</abbr>
 783 Schema: Datatypes &ndash; dateTime</a> specifies a format inspired by
 784 <abbr>ISO</abbr> 8601 that is in common use in <abbr>XML</abbr> data.</li>
 785 <li>
 786 <a href="https://tools.ietf.org/html/rfc5322">Internet
 787 Message Format</a> (Internet <abbr>RFC</abbr> 5322) &sect;3.3
 788 specifies the time notation used in email and <a
 789 href="https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol"><abbr>HTTP</abbr></a>
 790 headers.</li>
 791 <li>
 792 <a href="https://tools.ietf.org/html/rfc3339">Date and Time
 793 on the Internet: Timestamps</a> (Internet <abbr>RFC</abbr> 3339)
 794 specifies an <abbr>ISO</abbr> 8601
 795 profile for use in new Internet
 796 protocols.</li>
 797 <li>
 798 <a href="https://www.hackcraft.net/web/datetime/">Date &amp; Time
 799 Formats on the Web</a> surveys web- and Internet-oriented date and time
 800 formats.</li>
 801 <li>
 802 <a href="http://exit109.com/~ghealton/y2k/yrexamples.html">The
 803 Best of Dates, the Worst of Dates</a> covers many problems encountered
 804 by software developers when handling dates and time stamps.</li>
 805 <li>Alphabetic time zone abbreviations should not be used as unique
 806 identifiers for <abbr>UTC</abbr> offsets as they are ambiguous in
 807 practice. For example, in English-speaking North America
 808 "<abbr>CST</abbr>" denotes 6 hours behind <abbr>UTC</abbr>,
 809 but in China it denotes 8 hours ahead of <abbr>UTC</abbr>,
 810 and French-speaking North Americans prefer
 811 "<abbr title="Heure Normale du Centre">HNC</abbr>" to
 812 "<abbr>CST</abbr>". For <abbr>POSIX</abbr> the <code><abbr>tz</abbr></code>
 813 database contains English abbreviations for all time stamps but in
 814 many cases these are merely inventions of the database
 815 maintainers.</li>
 816 <li>Numeric time zone abbreviations typically count hours east of
 817 <abbr>UTC</abbr>, e.g., +09 for Japan and
 818 &minus;10 for Hawaii. However, the <abbr>POSIX</abbr>
 819 <code><abbr>TZ</abbr></code> environment variable uses the opposite convention.
 820 For example, one might use <code><abbr>TZ</abbr>="<abbr
 821 title="Japan Standard Time">JST</abbr>-9"</code> and
 822 <code><abbr>TZ</abbr>="<abbr title="Hawaii Standard Time">HST</abbr>10"</code>
 823 for Japan and Hawaii, respectively. If the
 824 <code><abbr>tz</abbr></code> database is available, it is usually better to use
 825 settings like <code><abbr>TZ</abbr>="Asia/Tokyo"</code> and
 826 <code><abbr>TZ</abbr>="Pacific/Honolulu"</code> instead, as this should avoid
 827 confusion, handle old time stamps better, and insulate you better from
 828 any future changes to the rules. One should never set
 829 <abbr>POSIX</abbr> <code><abbr>TZ</abbr></code> to a value like
 830 <code>"GMT-9"</code>, though, since this would falsely claim that
 831 local time is nine hours ahead of <abbr>UTC</abbr> and the time zone
 832 is called "<abbr>GMT</abbr>".</li>
 833 </ul>
 834 <h2>See also</h2>
 835 <ul>
 836 <li><a href="tz-art.htm">Time and the Arts</a></li>
 837 </ul>
 838 <hr>
 839 <address>
 840 This web page is in the public domain, so clarified as of
 841 2009-05-17 by Arthur David Olson.
 842 <br>
 843 Please send corrections to this web page to the
 844 <a href="mailto:tz@iana.org">time zone mailing list</a>.
 845 </address>
 846 </body>
 847 </html>