Manpages

NAME

timedatectl - 控 制 系 統 的 時 間 與 日 期

SYNOPSIS

timedatectl [OPTIONS...] {COMMAND}

描 述

timedatectl 可 用 於 查 詢 與 修 改 系 統 時 鐘 的 各 項 設 置 。 可 以 使 用 systemd-firstboot(1) 初 始 化 已 掛 載 (但 未 啓 動 )的 系 統 鏡 像 的 時 區 設 置 。

選 項

能 夠 識 別 的 命 令 行 選 項 如 下 ：

--no-ask-password 在 執 行 特 權 操 作 時 不 向 用 戶 索 要 密 碼 。

--adjust-system-clock 當 使 用 set-local-rtc 命 令 時 ， 若 使 用 了 此 選 項 ， 則 表 示 根 據 RTC時 間 來 更 新 系 統 時 鐘 。 若 未 使 用 此 選 項 ， 則 表 示 根 據 系 統 時 鐘 來 更 新 RTC時 間 。

-H, --host= 操 作 指 定 的 遠 程 主 機 。 可 以 僅 指 定 一 個 主 機 名 (hostname)， 也 可 以 使 用 "username@hostname" 格 式 。 hostname 後 面 還 可 以 加 上 容 器 名 (以 冒 號 分 隔 )， 也 就 是 形 如 "hostname:container" 的 格 式 ， 以 表 示 直 接 連 接 到 指 定 主 機 的 指 定 容 器 內 。 操 作 將 通 過 SSH協 議 進 行 ， 以 確 保 安 全 。 可 以 通 過 machinectl -H HOST 命 令 列 出 遠 程 主 機 上 的 所 有 容 器 名 稱 。

-M, --machine= 在 本 地 容 器 內 執 行 操 作 。 必 須 明 確 指 定 容 器 的 名 稱 。

-h, --help 顯 示 簡 短 的 幫 助 信 息 並 退 出 。

--version 顯 示 簡 短 的 版 本 信 息 並 退 出 。

--no-pager 不 將 程 序 的 輸 出 內 容 管 道 (pipe)給 分 頁 程 序 。 能 夠 識 別 的 命 令 如 下 ：

status 顯 示 系 統 時 鐘 與 RTC的 當 前 狀 態 ， 包 括 時 區 設 置 與 網 絡 時 間 同 步 服 務 的 狀 態 。 注 意 ， 所 謂 "網 絡 時 間 同 步 服 務 的 狀 態 "實 際 上 只 是 systemd-timesyncd.service 服 務 的 狀 態 ， 並 不 檢 查 是 否 存 在 其 他 時 間 同 步 服 務 。 這 是 默 認 命 令 。

set-time [TIME] 將 系 統 時 鐘 設 爲 指 定 的 時 間 ， 並 同 時 更 新 RTC時 間 。 [TIME] 是 一 個 形 如 "2012-10-30 18:17:16"的 時 間 字 符 串 。

set-timezone [TIMEZONE] 設 置 系 統 時 區 ， 也 就 是 更 新 /etc/localtime 軟 連 接 的 指 向 。 可 以 用 下 面 的 list-timezones 命 令 列 出 所 有 可 用 時 區 。 如 果 RTC被 設 爲 本 地 時 間 ， 此 命 令 還 會 同 時 更 新 RTC時 間 。 詳 見 localtime(5) 手 冊 。

list-timezones 列 出 所 有 可 用 時 區 ， 每 行 一 個 。 列 出 的 值 可 以 用 作 前 述 set-timezone 命 令 的 參 數 。

set-local-rtc [BOOL] 設 爲 "no" 表 示 在 RTC中 存 儲 UTC時 間 ； 設 爲 "yes" 表 示 在 RTC中 存 儲 本 地 時 間 。 應 該 盡 一 切 可 能 在 RTC中 存 儲 UTC時 間 。 儘 量 不 要 在 RTC中 存 儲 本 地 時 間 ， 因 爲 這 會 造 成 一 系 列 麻 煩 ， 尤 其 是 在 切 換 時 區 以 及 調 整 夏 令 時 或 冬 令 時 的 時 候 。 注 意 ， 除 非 明 確 使 用 了 --adjust-system-clock 選 項 ， 否 則 此 命 令 還 會 同 時 用 系 統 時 鐘 更 新 RTC時 間 。 此 命 令 還 會 改 變 /etc/adjtime 文 件 第 三 行 的 內 容 ， 詳 見 hwclock(8) 手 冊 。

set-ntp [BOOL] 是 否 開 啓 網 絡 時 間 同 步 。 設 爲 "yes" 則 啓 用 並 啓 動 systemd-timesyncd.service 服 務 ， 設 爲 "no" 則 停 止 並 停 用 它 。 該 命 令 除 了 控 制 systemd-timesyncd.service 服 務 的 狀 態 ， 不 做 任 何 其 他 操 作 。 也 就 是 說 ， 設 爲 "yes" 相 當 於 執 行 systemctl enable --now systemd-timesyncd.service 命 令 ； 而 設 爲 "no" 則 相 當 於 執 行 systemctl disable --now systemd-timesyncd.service 命 令 ； 注 意 ， 即 使 使 用 此 命 令 關 閉 了 systemd-timesyncd.service 服 務 ， 仍 然 有 可 能 存 在 其 他 時 間 同 步 服 務 。 另 外 ， 嚴 格 來 說 ， systemd-timesyncd.service 除 了 同 步 時 間 之 外 ， 還 同 時 兼 有 其 他 功 能 ， 例 如 在 無 網 絡 且 無 RTC的 系 統 上 維 持 系 統 的 "單 調 時 鐘 "。 詳 見 systemd-timesyncd.service(8) 手 冊 。

退 出 狀 態

返 回 值 爲 0 表 示 成 功 ， 非 零 返 回 值 表 示 失 敗 代 碼 。

環 境 變 量

$SYSTEMD_PAGER 指 定 分 頁 程 序 。 僅 在 未 指 定 --no-pager 選 項 時 有 意 義 。 此 變 量 會 覆 蓋 $PAGER 的 值 。 將 此 變 量 設 爲 空 字 符 串 或 "cat" 等 價 於 使 用 --no-pager 選 項 。

$SYSTEMD_LESS 用 於 覆 蓋 默 認 傳 遞 給 less 程 序 的 命 令 行 選 項 ("FRSXMK")。

例 子

顯 示 當 前 的 時 間 設 置

$ timedatectl
Local time: Di 2015-04-07 16:26:56 CEST
Universal time: Di 2015-04-07 14:26:56 UTC
RTC time: Di 2015-04-07 14:26:56
Time zone: Europe/Berlin (CEST, +0200)
Network time on: yes
NTP synchronized: yes
RTC in local TZ: no 開 啓 網 絡 時 間 同 步 服 務

$ timedatectl set-ntp true
==== AUTHENTICATING FOR org.freedesktop.timedate1.set-ntp ===
Authentication is required to control whether network time synchronization shall be enabled.
Authenticating as: user
Password: ********
==== AUTHENTICATION COMPLETE ===

$ systemctl status systemd-timesyncd.service
● systemd-timesyncd.service - Network Time Synchronization
Loaded: loaded (/usr/lib/systemd/system/systemd-timesyncd.service; enabled)
Active: active (running) since Mo 2015-03-30 14:20:38 CEST; 5s ago
Docs: man:systemd-timesyncd.service(8)
Main PID: 595 (systemd-timesyn)
Status: "Using Time Server 216.239.38.15:123 (time4.google.com)."
CGroup: /system.slice/systemd-timesyncd.service
└─595 /usr/lib/systemd/systemd-timesyncd
...

參 見

systemd(1), hwclock(8), date(1), localtime(5), systemctl(1), systemd-timedated.service(8), systemd-timesyncd.service(8), systemd-firstboot(1)

跋

本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。 翻 譯 人 員 ： 金 步 國 金 步 國 作 品 集 ： http://www.jinbuguo.com 中 文 man 手 冊 頁 計 劃 ： https://github.com/man-pages-zh/manpages-zh