xref: /illumos-gate/usr/src/data/zoneinfo/README (revision bbf215553c7233fbab8a0afdf1fac74c44781867)
1503609a9SYuri PankovCopyright (c) 1999, 2010, Oracle and/or its affiliates. All rights reserved.
2503609a9SYuri Pankov
3503609a9SYuri PankovThe /usr/share/lib/zoneinfo/src directory contains zoneinfo timezone source
4*bbf21555SRichard Lowefiles.  These source files have been compiled using zic(8) to create
5503609a9SYuri Pankovthe zoneinfo data files in /usr/share/lib/zoneinfo.  The zic command can be
6503609a9SYuri Pankovused with the zoneinfo source files to create additional data files.
7503609a9SYuri Pankov
8503609a9SYuri PankovThe zoneinfo files track the Olson public source provided at
9503609a9SYuri Pankovftp://elsie.nci.nih.gov/pub/, therefore zoneinfo files may be added and
10503609a9SYuri Pankovremoved as the Solaris source is updated.  The current Solaris release of
11503609a9SYuri Pankovthe zoneinfo files is based on tzdata2010k.tar.gz.
12503609a9SYuri Pankov
13503609a9SYuri PankovThe /usr/share/lib/zoneinfo/GMT[+-]* timezones listed below have been
14503609a9SYuri Pankovremoved from the release.  Replace usage of the
15503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT[+-]* files with the equivalent quoted timezone
16*bbf21555SRichard Lowe(see environ(7)).  Note the signs of the offsets of the equivalent quoted
17503609a9SYuri Pankovtimezone are reversed from the signs of the /usr/share/lib/zoneinfo/GMT[+-]*
18503609a9SYuri Pankovfiles.
19503609a9SYuri Pankov
20503609a9SYuri PankovFor example, replace TZ=:GMT+1, with TZ="<GMT-1>-1".  (The colon (:) is
21503609a9SYuri Pankovsignificant.  Without the colon, for example TZ=GMT+1, an unquoted timezone
22503609a9SYuri Pankovis used;  unquoted timezones are not affected by the removal of the zoneinfo
23503609a9SYuri Pankovtimezone files listed below.)
24503609a9SYuri Pankov
25503609a9SYuri PankovThe following files have been removed from the release:
26503609a9SYuri Pankov
27503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT-12
28503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT-11
29503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT-10
30503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT-9
31503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT-8
32503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT-7
33503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT-6
34503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT-5
35503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT-4
36503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT-3
37503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT-2
38503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT-1
39503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT+1
40503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT+2
41503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT+3
42503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT+4
43503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT+5
44503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT+6
45503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT+7
46503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT+8
47503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT+9
48503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT+10
49503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT+11
50503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT+12
51503609a9SYuri Pankov/usr/share/lib/zoneinfo/GMT+13
52503609a9SYuri Pankov
53503609a9SYuri PankovAs zoneinfo timezones are updated, the savings/daylight transition rules
54503609a9SYuri Pankovand timezone name abbreviations may change.  This can affect how
55503609a9SYuri Pankovthe times are calculated in the local timezone.  Therefore the interpretation
56503609a9SYuri Pankovof a time_t value can vary amongst Solaris releases that use different
57503609a9SYuri Pankovversions of the zoneinfo timezones.
58503609a9SYuri Pankov
59503609a9SYuri PankovThe zoneinfo timezone data files do not transition past
60503609a9SYuri PankovTue Jan 19 03:14:07 2038 GMT.  Therefore for 64-bit applications using
61503609a9SYuri Pankovzoneinfo timezones, calculations beyond this date may not use the correct
62503609a9SYuri Pankovoffset from standard time, and could return incorrect values.  This affects
63503609a9SYuri Pankov64-bit versions of interfaces such as ascftime(3C), cftime(3C), ctime(3C),
64503609a9SYuri Pankovgetdate(3C), ftime(3C), mktime(3C), and localtime(3C).
65503609a9SYuri Pankov
66*bbf21555SRichard LoweFor more information see zic(8), zdump(8), environ(7), TIMEZONE(5),
67503609a9SYuri Pankovctime(3C), and mktime(3C) man pages.
68