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