tree: 1e7bfa5e921e5773deb3f2213a047733fdefbee9 [path history] [tgz]
  1. meta/
  2. test/
  3. BUILD.gn
  4. README.md
src/intl/tzdata_provider/README.md

tzdata-provider

tzdata-provider is a component that provides ICU timezone data to other components via directory capabilities that contain data files used by the ICU library. The user documentation is provided on the Fuchsia website, while here we document the provider side.

tzdata-provider is a component without an included executable program. Its purpose is only to provide capability routing for ICU timezone data files.

Providing these capabilities is achieved via multiple steps.

  1. The tzdata-provider is built with time zone resources baked into its package. Any system that includes tzdata-provider will have these files available. For the time being only one provider is run as the data schema version of the ICU tzdata has not changed over many years. The exposed resources are files, and are as follows:
    • revision.txt: a text file containing the ICU data version, such as 2023c. Used for version verification.
    • metaZones.res, timezoneTypes.res and zoneinfo64.res: the ICU library resource files containing the time zone information that we need.
  2. The tzdata-provider component manifest is configured to expose the directory capabilities that correspond to the resources exposed.
  3. A core shard is provided for products to include in their assembly configuration.

Note: in the past, time zone data files used to be provided via the config-data mechanism. This is no longer the case, and if you come across a place where config-data is mentioned when talking about time zone provision, feel free to file a bug.

zoneinfo-provider

zoneinfo-provider is a component that provides TZIF zoneinfo files to other to other components via directory capabilities.

zoneinfo-provider is a component without an included executable program. Its purpose is only to provide capability routing.

Resource provision here is similar to the routing used by tzdata-provider above.