• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1---
2title: Update Time Zone Data for ZoneParser
3---
4
5# Update Time Zone Data for ZoneParser
6
7Note: This is usually done as a part of full time zone data update process.
8
91. Download the latest version of IANA Time Zone Database page: https://www.iana.org/time\-zones
10    - There are 3 links available for latest version. Select the complete distribution tzdb\-\<version\>.tar.lz (e.g. tzdb\-2021a.tar.lz).
11    - Extract entire contents to a work directory.
12    - **Note**: The data only distribution contains minimum set of files you really need. However, you cannot use a convenient make target without codes. The complete distribution package contains the codes.
132. Run make target \- rearguard\_tarballs\_version
14    - This target creates "rearguard" version of zoneinfo files under directory: tzdataunknown\-rearguard.dir.
15    - **Note**: If you specify a version (e.g. VERSION\=2021\) when invoking the target, "unknown" will be replaced with the specified version (e.g. tzdata2021a\-rearguard.dir), but it's not important in this instruction.
16    - A standard zoneinfo file may use negative daylight saving time offsets. CLDR code currently can not handle negative daylight saving time offsets. The "rearguard" version is designed for tools without negative daylight saving time support.
173. Copy files generated by previous step to {CLDR\_DIR}/tools/cldr\-code/src/main/resources/org/unicode/cldr/util/data
18    - Below the list of files to be include:
19        - africa
20        - antarctica
21        - asia
22        - australasia
23        - backward
24        - etcetera
25        - europe
26        - leapseconds
27        - northamerica
28        - southamerica
29        - zone.tab
30    - **Note**: leapseconds might be removed from the list later.
314. Edit the file {CLDR\_DIR}}/tools/cldr\-code/src/main/resources/org/unicode/cldr/util/data/tzdb\-version.txt
32    - This file contains just one line text specifying a version of Time Zone Database, e.g. 2021a.
335. **Record the version: See** [**Updating External Metadata**](https://cldr.unicode.org/development/updating-codes/external-version-metadata)
34
35