Manpages

______________________________________________________________________________

NAME

clock - 获 取 和 操 纵 时 间

总 览 SYNOPSIS

clock option ?arg arg ...? _________________________________________________________________

描 述 DESCRIPTION

这 个 命 令 进 行 多 种 操 作 中 的 某 一 个 ， 可 以 获 取 或 操 纵 表 示 一 些 时 间 概 念 (notion)的 字 符 串 或 值 。 option 参 数 确 定 这 个 命 令 完 成 什 么 操 作 。 合 法 的 options (可 以 使 用 缩 写 ) 有 :

clock clicks ?-milliseconds? │ 返 回 一 个 高 解 析 度 (high-resolution)的 时 间 值 ， 是 一 个 依 赖 于 系 统 的 整 │ 数 。 值 的 单 位 是 依 赖 于 系 统 的 但 应 该 是 系 统 上 可 获 得 的 最 高 解 析 度 的 时 │ 钟 ， 比 如 一 个 CPU 周 期 记 数 (counter)。 如 果 指 定 了 -milliseconds │ ， 则 保 证 这 个 值 是 微 秒 的 粒 度 。 这 个 值 只 应 用 于 流 逝 了 的 时 间 的 相 对 测 │ 量 。
clock format clockValue ?-format string? ?-gmt boolean? 把 一 个 整 数 时 间 值 转 换 成 人 可 阅 读 的 形 式 ， 典 型 的 ， 这 个 时 间 值 是 从 clock seconds、 clock scan、 或 file 命 令 的 atime、 mtime、 或 ctime 选 项 返 回 的 。 如 果 -format 参 数 存 在 ， 下 一 个 参 数 是 描 述 如 何 格 式 化 日 期 和 时 间 的 一 个 字 符 串 。 字 段 描 述 符 由 一 个 % 和 随 后 的 字 段 描 述 符 字 符 组 成 。 所 有 的 其 他 字 符 都 复 制 到 结 果 中 。 有 效 的 字 段 描 述 符 有 :

%% 插 入 一 个

%。

%a 星 期 名 的 缩

写 (Mon, Tue, etc.)。
%A 完 整 的 星 期 名 (Monday, Tuesday, etc.)。
%b 月 名 的 缩 写 (Jan, Feb, etc.)。
%B 完 整 的 月 名 。
%c 特 定 于 本 地 的

日 期 和 时 间 。

%d 月 中 的 第 几 天

(01 - 31)。

%H

24小 时 格 式 的 小 时 (00 - 23)。

%I

12小 时 格 式 的 小 时 (00 - 12)。

%j

年 中 的 第 几 天 (001 - 366)。
%m 第 几 月 (01 - 12)。
%M 分

(00 - 59)。

%p

AM/PM 指 示 符 。

%S

秒 (00 - 59)。

%U 年 中

的 第 几 星 期 (00 - 52)， 星 期 天 是 一 个 星 期 中 的 第 一 天 。
%w 星 期 几 (Sunday = 0)。

%W 年 中 的 第

几 星 期 (00 - 52)， 星 期 一 是 一 个 星 期 中 的 第 一 天 。
%x 特 定 于 本 地 的 日 期

格 式 。

%X 特 定 于 本 地 的 时 间 格 式 。

%y 世 纪 中 的 第 几 年

(00 - 99)。

%Y 带 世 纪 的 年

(例 如 1990)。

%Z 时 区 名 。 在 一 些 系 统 上 支 持 下

列 补 充 的 字 段 描 述 符 (例 如 在 Unix 上 而 不 在 Windows):

%D 形 如

%m/%d/%y 的 日 期 。

%e 月 中 的

第 几 天 (1 - 31)， 没 有 前 导 的 零 。
%h 月 名 的 缩 写 。
%n 插 入 一 个 换 行 。
%r 形 如

%I:%M:%S %p 的 时 间 。

%R 形 如

%H:%M 的 时 间 。

%t 插 入 一

个 tab。
%T 形 如 %H:%M:%S 的 时 间 。

如 果 未 指 定 -format 参 数 ， 使 用 格 式 串 “%a %b %d %H:%M:%S %Z %Y”。 如 果 -gmt 参 数 存 在 ， 下 一 个 参 数 必 须 是 一 个 boolean (值 )。 如 果 是 真 则 指 定 时 间 作 为 Greenwich 标 准 时 来 格 式 化 ， 如 果 是 假 则 使 用 操 作 环 境 定 义 的 本 地 时 区 。

clock scan dateString ?-base clockVal? ?-gmt boolean? 把 dateString 转 换 成 一 个 整 数 时 钟 值 (参 见 clock seconds)。 这 个 命 令 可 分 析 并 转 换 几 乎 所 有 的 标 准 的 日 期 和 /或 时 间 串 ， 其 中 可 以 包 含 标 准 的 时 区 助 记 码 (mnemonic)。 如 果 只 指 定 了 一 个 时 间 ， 假 定 为 当 前 的 日 期 。 如 果 串 中 不 包 括 一 个 时 区 助 记 码 ， 除 非 -gmt 参 数 是 真 之 外 假 定 为 本 地 时 区 ， 在 -gmt 参 数 是 真 的 情 况 下 ， 假 定 指 定 的 时 间 是 相 对 于 Greenwich 标 准 时 来 计 算 时 钟 值 。 如 果 指 定 了 -gmt， 它 只 影 响 计 算 出 的 时 间 值 ， 不 影 响 对 -base 的 解 释 。 如 果 指 定 了 -base 标 记 ， 下 一 个 参 数 将 包 括 一 个 整 数 的 时 钟 值 。 只 使 用 这 个 值 中 的 日 期 而 不 管 时 间 。 这 对 确 定 特 定 的 某 天 的 时 间 或 做 其 他 的 相 对 于 日 期 的 转 换 有 用 。

dateString 包 含 零 个 或 多 个 下 列 形 式 的 指 定 (specification):

time 一 天 中 的 时 间 ， 样 式 是 :

hh?:mm?:ss?? ?meridian? ?zone? or

hhmm ?meridian? ?zone?. 如 果 为 指 定 上 下 午 (meridian), hh 被 解 释 为 一 个 24小 时 钟 点 。

date 一 个 特 定 的 月 和 日 ， 年 是 可 选 的 。 可 接 受 的 格 式 是

mm/dd?/yy?,

monthname dd ?, yy?, dd monthname ?yy?, day, dd monthname yy, ?CC?yymmdd, ?CC?yy-mm-dd, dd-monthname-?CC?yy. 缺 省 的 年 是 当 前 年 。 如 果 年 小 于 100， 我 们 把 00-68 年 作 为 2000-2068 │ 年 而 69-99 年 作 为 1969-1999 年 。 注 意 所 有 平 台 都 可 以 表 示 │ 38-70 年 , 所 以 如 果 使 用 这 些 年 就 可 能 出 错 。

ISO 8601 point-in-time 一 个 ISO 8601 point-in-time 指 定 ， 如 CCyymmddThhmmss, 这 里 T 是 字 面 的 T， CCyymmdd hhmmss, 或 者 CCyymmddThh:mm:ss.
relative time 相 对 当 前 时 间 的 一 个 指 定 。 格 式 是 number unit， 可 接 受 的 单 位 是 year、 fortnight、 month、 week、 day、 hour、 minute (或 min)、 和 second (或 sec)。 单 位 可 以 被 指 定 为 单 数 或 复 数 ， 比 如 3 weeks。 还 可 以 指 定 这 些 修 饰 符 : tomorrow、 yesterday、 today、 now、 last、 this、 next、 ago。 实 际 的 日 期 计 算 依 照 下 列 的 步 骤 。 首 先 ， 处 理 和 转 换 所 有 绝 对 日 期 和 /或 时 间 。 使 用 这 个 时 间 作 为 基 准 (base),添 加 上 星 期 几 (day-of-week)指 定 。 其 次 ， 使 用 相 对 指 定 。 如 果 指 定 了 一 个 日 期 或 某 天 ， 并 且 没 有 给 出 绝 对 或 相 对 的 时 间 ， 则 使 用 午 夜 。 最 后 ， 进 行 一 次 校 正 ， 这 样 就 在 估 计 了 夏 令 时 不 同 之 后 产 生 正 确 的 一 天 中 的 小 时 ， 并 且 在 从 一 个 大 月 结 束 到 一 个 小 月 时 给 出 正 确 的 日 期 。 只 在 用 如 下 单 位 指 定 相 对 时 间 的 时 候 进 行 夏 令 时 校 正 ， 日 或 更 多 ， 例 如 days、 weeks、 fortnights、 months 或 years。 这 意 味 着 跨 越 夏 令 时 边 界 的 时 候 ， 对 clock scan “1 day” 和 clock scan “24 hours” 将 给 出 不 同 的 结 果 :

% clock scan "1 day" -base [clock scan 1999-10-31]
941443200
% clock scan "24 hours" -base [clock scan 1999-10-31]
941439600

clock seconds 把 当 前 的 日 期 和 时 间 作 为 依 赖 于 系 统 的 整 数 值 返 回 。 值 的 单 位 是 秒 ， 允 许 它 被 用 于 相 对 时 间 的 计 算 。 值 通 常 被 定 义 成 从 “epoch”开 始 (至 今 )总 共 流 逝 的 时 间 。 你 不 应 该 假 定 epoch 的 值 。

关 键 字 KEYWORDS

clock, date, time

[中 文 版 维 护 人 ]

寒 蝉 退 士

[中 文 版 最 新 更 新 ]

2001/06/21

《 中 国 Linux 论 坛 man 手 册 页 翻 译 计 划 》 :

http://cmpp.linuxforum.net

跋

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