______________________________________________________________________________
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 手 册 页 翻 译 计 划 》 :
跋
本 页 面 中 文 版 由 中 文 man 手 册 页 计 划 提 供 。 中 文 man 手 册 页 计 划 ： https://github.com/man-pages-zh/manpages-zh