______________________________________________________________________________
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