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_timecnt 個 unsigned 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
跋
本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。 中 文 man 手 冊 頁 計 劃 : https://github.com/man-pages-zh/manpages-zh