xref: /illumos-gate/usr/src/data/zoneinfo/README (revision 66582b606a8194f7f3ba5b3a3a6dca5b0d346361)
1Copyright (c) 1999, 2010, Oracle and/or its affiliates. All rights reserved.
2
3The /usr/share/lib/zoneinfo/src directory contains zoneinfo timezone source
4files.  These source files have been compiled using zic(1M) to create
5the zoneinfo data files in /usr/share/lib/zoneinfo.  The zic command can be
6used with the zoneinfo source files to create additional data files.
7
8The zoneinfo files track the Olson public source provided at
9ftp://elsie.nci.nih.gov/pub/, therefore zoneinfo files may be added and
10removed as the Solaris source is updated.  The current Solaris release of
11the zoneinfo files is based on tzdata2010k.tar.gz.
12
13The /usr/share/lib/zoneinfo/GMT[+-]* timezones listed below have been
14removed from the release.  Replace usage of the
15/usr/share/lib/zoneinfo/GMT[+-]* files with the equivalent quoted timezone
16(see environ(5)).  Note the signs of the offsets of the equivalent quoted
17timezone are reversed from the signs of the /usr/share/lib/zoneinfo/GMT[+-]*
18files.
19
20For example, replace TZ=:GMT+1, with TZ="<GMT-1>-1".  (The colon (:) is
21significant.  Without the colon, for example TZ=GMT+1, an unquoted timezone
22is used;  unquoted timezones are not affected by the removal of the zoneinfo
23timezone files listed below.)
24
25The following files have been removed from the release:
26
27/usr/share/lib/zoneinfo/GMT-12
28/usr/share/lib/zoneinfo/GMT-11
29/usr/share/lib/zoneinfo/GMT-10
30/usr/share/lib/zoneinfo/GMT-9
31/usr/share/lib/zoneinfo/GMT-8
32/usr/share/lib/zoneinfo/GMT-7
33/usr/share/lib/zoneinfo/GMT-6
34/usr/share/lib/zoneinfo/GMT-5
35/usr/share/lib/zoneinfo/GMT-4
36/usr/share/lib/zoneinfo/GMT-3
37/usr/share/lib/zoneinfo/GMT-2
38/usr/share/lib/zoneinfo/GMT-1
39/usr/share/lib/zoneinfo/GMT+1
40/usr/share/lib/zoneinfo/GMT+2
41/usr/share/lib/zoneinfo/GMT+3
42/usr/share/lib/zoneinfo/GMT+4
43/usr/share/lib/zoneinfo/GMT+5
44/usr/share/lib/zoneinfo/GMT+6
45/usr/share/lib/zoneinfo/GMT+7
46/usr/share/lib/zoneinfo/GMT+8
47/usr/share/lib/zoneinfo/GMT+9
48/usr/share/lib/zoneinfo/GMT+10
49/usr/share/lib/zoneinfo/GMT+11
50/usr/share/lib/zoneinfo/GMT+12
51/usr/share/lib/zoneinfo/GMT+13
52
53As zoneinfo timezones are updated, the savings/daylight transition rules
54and timezone name abbreviations may change.  This can affect how
55the times are calculated in the local timezone.  Therefore the interpretation
56of a time_t value can vary amongst Solaris releases that use different
57versions of the zoneinfo timezones.
58
59The zoneinfo timezone data files do not transition past
60Tue Jan 19 03:14:07 2038 GMT.  Therefore for 64-bit applications using
61zoneinfo timezones, calculations beyond this date may not use the correct
62offset from standard time, and could return incorrect values.  This affects
6364-bit versions of interfaces such as ascftime(3C), cftime(3C), ctime(3C),
64getdate(3C), ftime(3C), mktime(3C), and localtime(3C).
65
66For more information see zic(1M), zdump(1M), environ(5), TIMEZONE(4),
67ctime(3C), and mktime(3C) man pages.
68