用于在 Linux 中设置或查询系统时间、日期和时区等配置。

补充说明

在 Linux 运维中,通常使用此命令来设置或更改当前的日期、时间和时区,或启用自动系统时钟与远程 NTP 服务器同步,以确保 Linux 系统始终保持正确的时间。

概要

1
timedatectl [OPTIONS...] COMMAND ...

主要用途

  • 转换时间到选定的格式,默认为当前。
  • 设置系统时间。

参数

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
Query or change system time and date settings.

-h --help 显示帮助信息。
--version 显示软件包版本。
--no-pager 不用将输出通过管道传输到寻呼机(pager)。
--no-ask-password 不提示输入密码。
-H --host=[USER@]HOST 在远程主机上操作
-M --machine=CONTAINER 在本地容器上操作。
--adjust-system-clock 更改本地 RTC 模式时调整系统时钟。
--monitor 监控systemd-timesyncd的状态
-p --property=NAME 仅显示此名称的属性
-a --all 显示所有属性,包括空属性
--value 显示属性时,只打印值

Commands:
status 显示当前的时间设置。
set-time TIME 设置系统时间。
set-timezone ZONE 设置系统时区。
list-timezones 显示已知时区。
set-local-rtc BOOL 控制 RTC 是否在当地时间。(BOOL 的值可以是 1 / true 或 0 / false)
set-ntp BOOL 启用或禁用网络时间同步。(BOOL 的值可以是 1 / true 或 0 / false)
timesync-status 显示 systemd-timesyncd 的状态。
show-timesync 显示 systemd-timesyncd 的属性。

例子

显示系统当前时间和日期

1
2
3
4
5
6
7
8
9
$ timedatectl status
Local time: 五 2022-04-08 17:06:40 CST
Universal time: 五 2022-04-08 09:06:40 UTC
RTC time: 五 2022-04-08 17:04:02
Time zone: Asia/Shanghai (CST, +0800)
NTP enabled: n/a
NTP synchronized: no
RTC in local TZ: yes
DST active: n/a

显示系统所有可用的时区

1
2
3
4
5
6
$ timedatectl show
Unknown operation show
$ timedatectl list-timezones
Africa/Abidjan
Africa/Accra
Africa/Addis_Ababa

将本地时区从上海(Asia/Shanghai)设置为阿姆斯特丹(Europe/Amsterdam)

1
$ timedatectl set-timezone "Europe/Amsterdam"

将本地时区设置为协调世界时(UTC)

1
$ timedatectl set-timezone UTC

设置系统时间(格式:HH:MM:SS)

1
$ timedatectl set-time "07:25:46"

设置系统日期(格式:YYYY-MM-DD)

1
$ timedatectl set-time "2021-12-12"

如果只设置日期,那么时间将默认设置为 “00:00:00″(建议同时设置日期和时间)

1
$ timedatectl set-time "2021-12-12 07:25:46"

将硬件时钟(RTC)设置为本地时区(不建议,RTC 时钟统一使用 UTC 更恰当,避免在时区更改和夏令时调整方面产生各种问题)

1
$ timedatectl set-local-rtc 1

将硬件时钟(RTC)设置为协调世界时间(UTC)

1
$ timedatectl set-local-rtc 0

启用 NTP 自动时间同步

1
$ timedatectl set-ntp true

禁用 NTP 自动时间同步

1
$ timedatectl set-ntp false

查看 systemd-timesyncd 服务的状态

1
2
3
4
5
6
7
8
9
10
11
12
13
14
$ timedatectl timesync-status
Server: 91.189.94.4 (ntp.ubuntu.com)
Poll interval: 17min 4s (min: 32s; max 34min 8s)
Leap: normal
Version: 4
Stratum: 2
Reference: 91EECB0E
Precision: 1us (-23)
Root distance: 29.922ms (max: 5s)
Offset: +2.497ms
Delay: 199.540ms
Jitter: 5.834ms
Packet count: 6
Frequency: +13.039ppm

systemd-timedated 可能默认配置了谷歌的 NTP 服务器(如 time1.google.com),为了顺利完成网络时间同步,您可以编辑 /etc/systemd/timesyncd.conf 文件添加自己的 NTP 服务器地址。