Provided by: manpages-zh_1.6.3.2-1_all 
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