Man page - tzfile(5)

Packages contains this manual

Available languages:

en fr es ja zh_TW zh_CN de

Manual

TZFILE

NAME
SYNOPSIS
DESCRIPTION
SEE ALSO
跋

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

newctime(3)

跋

本 页 面 中 文 版 由 中 文 man 手 册 页 计 划 提 供 。
中 文 man 手 册 页 计 划 ： https://github.com/man-pages-zh/manpages-zh