Radar Component: TZ Database | all
Source Location: https://stash.sd.apple.com/projects/I18N/repos/TimeZoneData
The TimeZoneData project installs the tzcode and tzdata tar archives, as well as the latest data from ICU, into /usr/local/share/tz. It also soft-links the latest tzcode and tzdata archives so clients can find them.
The data is mastered into the internal SDKs, to be picked up by clients. Current clients are ICU, system_cmds, and TimeZoneAsset. ICU and TimeZoneAsset can pick up the data from /usr/local/share/tz, while system_cmds requires it to be in the SDK.
-
Subscribe to tz@iana.org, tz-announce@iana.org, and cldr-dev@googlegroups.com
-
When a new version of the TZ database is released by IANA, communicate with the CLDR/ICU team to see if any metazone or other changes are required.
-
If so, when the new ICU files are released to the ICU repository (https://github.com/unicode-org/icu), copy the following files into the icudata directory:
icu4c/source/data/misc/metaZones.txt icu4c/source/data/misc/timezoneTypes.txt icu4c/source/data/misc/windowsZones.txt icu4c/source/tools/tzcode/icuregions icu4c/source/tools/tzcode/icuzones -
Clone the tz repository from https://github.com/eggert/tz
-
Check out the tag corresponding to the release (e.g., 2020a)
-
Issue the following commands inside the repository:
make traditional_tarballs make rearguard_tarballs cp tzcodeYYYYL.tar.gz (TimeZoneData directory) cp tzdataYYYYL-rearguard.tar.gz (TimeZoneData directory)/tzdataYYYYL.tar.gz -
Inside TimeZoneData, remove the old tzcode and tzdata archives
-
Build a TimeZoneData root using buildit
-
cd to the root, and do:
sudo ditto . / -
Clone Apple ICU from https://stashweb.sd.apple.com/projects/I18N/repos/icu/browse and do:
make check -
There should be no errors in the tests. Further validation can be performed by producing a new version of TimeZoneAsset (https://stashweb.sd.apple.com/projects/I18N/repos/timezoneasset/browse), installing it, and performing a diff of all time zone transitions (see instructions in TimeZoneAsset)
-
Typically, TimeZoneData is only submitted to the build at the zero P2 deadline of a major OS release. The rest of the year we use OTA updates. However, every IANA release should get checked in.