|
Quick Links: |
Provide utilities for reading the Zoneinfo binary data format. More...
Namespaces | |
| namespace | baltzo |
| baltzo::ZoneinfoBinaryReader | utilities for reading Zoneinfo binary data |
struct, baltzo::ZoneinfoBinaryReader, containing utilities to read the binary data format of the Zoneinfo database from a bsl::istream and populate a baltzo::Zoneinfo object. The Zoneinfo database (also known as the Olson database or TZ database) records information about the world's time zones. It includes information such as the historic changes to the rules of local times, the time of transitions to daylight saving time, and corrections for leap seconds. http://www.iana.org/time-zones, including the time zone rules for the supported time zones, and source code for the zic compiler (for compiling those rules into the binary representation read by utility functions provided by this component). Byte | Name | Description ---------+-------------------+---------------------------------------------- 0 - 3 | 'T''Z''i''f' | magic characters to identify the file 4 | version | '\0', '2', or '3' to identify the version 5 - 19 | reserved | unused 20 - 23 | numIsGmt | number of UTC/local-time indicators 24 - 27 | numIsStd | number of standard/local-time indicators 28 - 31 | numLeaps | number of leap seconds corrections 32 - 35 | numTransitions | number of transition times 36 - 39 | numLocalTimeTypes | number of local-time types 40 - 43 | numAbbrevChar | length of time-zone abbreviation string ---------+-------------------+----------------------------------------------
File Segment Number of bytes +--------------------------------+ --------------- | HEADER | 44 +--------------------------------+ | TRANSITION TIMES | 4 * header.numTransitions +--------------------------------+ | TRANSITION-TIME INDEXES | 1 * header.numTransitions +--------------------------------+ | LOCAL-TIME TYPES | (4+1+1) * header.numLocalTimeTypes +--------------------------------+ | TIME-ZONE ABBREVIATION STRINGS | 1 * header.numAbbrevChar +--------------------------------+ | LEAP SECONDS | (4+4) * header.numLeaps +--------------------------------+ | IS_GMT(s) | 1 * header.numIsGmt +--------------------------------+ | IS_STD(s) | 1 * header.numIsStd +--------------------------------+
numTransitions number of 4-byte big-endian signed integers representing the transition times in POSIX time format (number of seconds elapsed since midnight UTC, January 1, 1970) sorted in ascending order. Each transition time represents a time at which the rule for computing the local time in that time zone changes. (NOTE: See "Version <code>2</code>" section for additional information.) numTransitions number of unsigned bytes. The byte at a given offset N stores the index of the local-time type entry (in the array of local-time types appearing next in the file) that corresponds to the transition at index N in the preceding sequence of transitions. LOCAL-TIME TYPES -- An array of numLocalTimeTypes local-time types, where each entry consist of:
numAbbrevChar number of bytes containing the abbreviation strings of the local-time types of this time zone. Each abbreviation string ends with the \0 character. numLeaps number of pairs of 4-byte signed big-endian integers (totaling 8 bytes). The first value of the pair is the POSIX time at which the leap seconds occur. The second value of the pair gives the number of leap seconds to be applied to times after the time defined by the first element of the pair. The pairs are stored in ascending order by time. (NOTE: See "Version <code>2</code>" section for additional information.) numIsGmt number of 1-byte booleans indicating whether the transition time for the local-time type with the corresponding index in the preceding array of local-time types was specified in UTC time or local time in the original rule file (from which the binary file was presumably compiled) (see next section for details). numIsStd number of 1-byte booleans indicating whether the transition time for the local-time type with the corresponding index in the preceding array of local-time types was specified in standard time or local time in the original rule file (from which the binary file was presumably compiled). Standard time refers to the time without adjustment for daylight-saving time whether daylight saving is in effect or not. (see next section for details). isGmt and isStd boolean flags are not used by this component. isGmt boolean flag indicates whether a transition time was originally specified as a UTC time or as a local time in the rule file. isStd indicates whether a transition time was originally specified as a standard time or local time. Note that all the transitions in the binary Zoneinfo representation are UTC times regardless of whether the original representation in the rule file was in local time. Also note that the value of numIsGmt and numIsStd should equal to numLocalTimeTypes, but for backward compatibility reasons, they may be set to zero. 2 format of the Zoneinfo binary data can be divided into two parts. The first part contains the header and data described above. The second part contains header and data in the same format with the exception that eight bytes are used for transition time and leap correction time. The second header and data is followed by a formatted string used for handling time after the last transition time. 2 format uses 8 bytes to store date-time values because the 4-byte values used in the version \0 format provide a limited date range. The standard IANA data contains many transitions that are outside the range of representable values of a 4-byte offset (these transitions are ignored by the version \0 format, which leads to inaccurate information for dates far in the past or future). 2 format adds an additional optional POSIX TZ environment string, holding a text description of the local time transitions of the timezone, which can be used to compute transitions beyond the range represented in the binary compiled time zone data (see ftp://ftp.iana.org/tz/code/tzfile.h). It is similar (but not necessarily identical to) POSIX time zone description used for the TZ environment variable. String is found between two newline \n characters immediately following the data. If two consecutive newline characters are found, no string has been specified. 2 data if it is present in the supplied binary data. 3 format of the Zoneinfo binary data is identical to the version 2 data described above. The version number of some files was incremented because the rules for the allowable range of values for the POSIX TZ environment string (found at the end of the data) were changed (see ftp://ftp.iana.org/tz/code/tzfile.h for more information). tzfile.5.txt. This file contains the most recent man-page text. baltzo::Zoneinfo object. We start by creating Zoneinfo data in memory for "Asia/Bangkok", which was chosen due to its small size. Note that this data was generated by the zic compiler, which is publicly obtainable as part of the standard Zoneinfo distribution (see http://www.iana.org/time-zones): const char ASIA_BANGKOK_DATA[] = { 0x54, 0x5a, 0x69, 0x66, 0x32, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x08, 0xa2, 0x6a, 0x67, 0xc4, 0x01, 0x00, 0x00, 0x5e, 0x3c, 0x00, 0x00, 0x00, 0x00, 0x62, 0x70, 0x00, 0x04, 0x42, 0x4d, 0x54, 0x00, 0x49, 0x43, 0x54, 0x00, 0x00, 0x00, 0x00, 0x00, 0x54, 0x5a, 0x69, 0x66, 0x32, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x03, 0x00, 0x00, 0x00, 0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x03, 0x00, 0x00, 0x00, 0x0c, 0xff, 0xff, 0xff, 0xff, 0x56, 0xb6, 0x85, 0xc4, 0xff, 0xff, 0xff, 0xff, 0xa2, 0x6a, 0x67, 0xc4, 0x01, 0x02, 0x00, 0x00, 0x5e, 0x3c, 0x00, 0x00, 0x00, 0x00, 0x5e, 0x3c, 0x00, 0x04, 0x00, 0x00, 0x62, 0x70, 0x00, 0x08, 0x4c, 0x4d, 0x54, 0x00, 0x42, 0x4d, 0x54, 0x00, 0x49, 0x43, 0x54, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x0a, 0x49, 0x43, 0x54, 0x2d, 0x37, 0x0a };
bdlsb::FixedMemInStreamBuf inStreamBuf(ASIA_BANGKOK_DATA, sizeof(ASIA_BANGKOK_DATA)); bsl::istream inputStream(&inStreamBuf);
inputStream using baltzo::ZoneinfoBinaryReader::read. baltzo::Zoneinfo timeZone; if (0 != baltzo::ZoneinfoBinaryReader::read(&timeZone, inputStream)) { bsl::cerr << "baltzo::ZoneinfoBinaryReader::load failed" << bsl::endl; return 1; //RETURN }
timeZone.print(bsl::cout, 1, 3);
[
identifier = ""
transitions = [
[
time = 01JAN0001_00:00:00.000
descriptor = [
utcOffsetInSeconds = 24124
dstInEffectFlag = false
description = "LMT"
]
]
[
time = 31DEC1879_17:17:56.000
descriptor = [
utcOffsetInSeconds = 24124
dstInEffectFlag = false
description = "BMT"
]
]
[
time = 31MAR1920_17:17:56.000
descriptor = [
utcOffsetInSeconds = 25200
dstInEffectFlag = false
description = "ICT"
]
]
]
]
1.7.1