Man page - timedatectl(1)

Packages contains this manual

Available languages:

en zh_TW zh_CN de

Manual

TIMEDATECTL

NAME
SYNOPSIS
描 述
選 項
退 出 狀 態
環 境 變 數
例 子
參 見
跋

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