Manpages

NAME

tzfile - 時 區 信 息

SYNOPSIS

#include <tzfile.h>

DESCRIPTION

時 區 信 息 文 件 被 tzset(3) 使 用 , 其 開 頭 爲 特 徵 字 符 "TZif", 以 此 標 示 該 文 件 爲 時 區 信 息 文 件 , 隨 後 六 個 字 節 保 留 未 用 . 接 下 來 是 六 個 "標 準 "字 節 順 序 (高 位 在 前 )的 四 字 節 long 類 型 值 , 按 順 序 描 述 如 下 :

tzh_ttisgmtcnt 保 存 在 文 件 中 的 UTC/local指 示 器 數 目 .
tzh_ttisstdcnt
保 存 在 文 件 中 的 standard/wall指 示 器 數 目 .
tzh_leapcnt
其 值 保 存 在 文 件 中 的 leap second的 數 目
tzh_timecnt
其 值 保 存 在 文 件 中 的 "變 化 時 間 "數 目
tzh_typecnt
其 值 保 存 在 文 件 中 的 "本 地 時 間 類 型 "數 目 (非 零 !)
tzh_charcnt
保 存 在 文 件 中 的 "時 區 簡 寫 符 "數 目 跟 在 上 面 這 些 頭 部 後 的 是 tzh_timecnt 個 "標 準 "字 節 順 序 的 四 字 節 long 類 型 值 , 以 升 序 排 序 . 每 個 值 均 作 爲 一 個 變 化 時 間 (就 像 time(2) 的 返 回 ), 系 統 依 賴 這 些 值 來 計 算 本 地 時 間 變 化 . 而 在 此 之 後 的 是 tzh_timecntunsigned char 類 型 的 一 字 節 值 , 這 些 值 指 出 了 文 件 中 描 述 的 多 種 "本 地 時 間 "類 型 中 哪 一 個 與 具 有 相 同 索 引 的 變 化 時 間 相 關 . 這 些 值 可 作 爲 ttinfo 結 構 數 組 的 索 引 . 而 ttinfo 結 構 在 文 件 中 隨 後 就 有 定 義 , 描 述 如 下 :

struct ttinfo {

long

tt_gmtoff;

int

tt_isdst;

unsigned int

tt_abbrind; }; 結 構 包 括 一 個 "標 準 "字 節 順 序 的 四 字 節 long 類 型 值 tt_gmtoff, 以 及 一 個 一 字 節 的 tt_isdst 和 一 個 一 字 節 的 tt_abbrind. 在 每 個 結 構 裏 , tt_gmtoff 給 出 了 要 被 加 到 UTC的 時 間 , 以 秒 爲 單 位 , tt_isdst 表 明 tm_isdst 是 否 可 通 過 localtime (3) 設 置 , 而 tt_abbrind 可 作 爲 時 區 簡 寫 符 的 數 組 索 引 , 該 數 組 在 文 件 中 跟 在 ttinfo 結 構 後 面 . 這 樣 就 有 tzh_leapcnt 個 標 準 字 節 順 序 的 四 字 節 對 , 每 個 四 字 節 對 的 第 一 個 值 給 出 一 個 leap second發 生 的 時 間 , 就 如 time(2) 的 返 回 ; 每 個 四 字 節 對 的 第 二 個 值 給 出 給 定 時 間 之 後 所 實 現 的 總 的 leap second數 . 四 字 節 對 按 時 間 的 升 序 排 序 . 同 樣 有 tzh_ttisstdcnt 個 standard/wall指 示 器 , 每 個 保 存 了 一 個 一 字 節 值 ; 這 些 指 示 器 指 出 了 變 化 時 間 (與 本 地 時 間 類 型 相 關 )是 否 被 說 明 爲 standard time或 者 wall clock time, 以 及 當 一 個 時 區 文 件 被 用 於 處 理 POSIX 格 式 時 區 環 境 變 量 時 是 否 使 用 變 化 時 間 . 最 後 , 有 tzh_ttisgmtcnt 個 UTC/local指 示 器 , 每 個 保 存 了 一 個 一 字 節 值 ; 這 些 指 示 器 指 出 了 變 化 時 間 (與 本 地 時 間 類 型 相 關 )是 否 被 說 明 爲 UTC 或 者 local time, 以 及 當 一 個 時 區 文 件 被 用 於 處 理 POSIX格 式 時 區 環 境 變 量 時 是 否 使 用 變 化 時 間 . 如 果 tzh_timecnt 等 於 零 或 者 時 間 參 數 比 文 件 記 錄 的 第 一 個 變 化 時 間 小 的 話 , Localtime 就 使 用 文 件 中 的 第 一 個 標 準 時 間 ttinfo, 或 者 在 沒 有 標 準 時 間 結 構 是 就 直 接 使 用 第 一 個 ttinfo 結 構 .

SEE ALSO

newctime(3)

本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。 中 文 man 手 冊 頁 計 劃 : https://github.com/man-pages-zh/manpages-zh