'\" t
.TH "TIMEDATECTL" "1" "" "systemd 231" "timedatectl"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
timedatectl \- 控制系統的時間與日期
.SH "SYNOPSIS"
.HP \w'\fBtimedatectl\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB{COMMAND}\fR\ 'u
\fBtimedatectl \fR\fB[OPTIONS...]\fR\fB \fR\fB{COMMAND}\fR
.SH "描述"
.PP
\fBtimedatectl\fR
可用於查詢與修改 系統時鐘的各項設置。
.PP
可以使用
\fBsystemd-firstboot\fR(1)
初始化已掛載(但未啓動)的系統鏡像的時區設置。
.SH "選項"
.PP
能夠識別的命令行選項如下：
.PP
\fB\-\-no\-ask\-password\fR
.RS 4
在執行特權操作時不向用戶索要密碼。
.RE
.PP
\fB\-\-adjust\-system\-clock\fR
.RS 4
當使用
\fBset\-local\-rtc\fR
命令時， 若使用了此選項， 則表示根據RTC時間來更新系統時鐘。 若未使用此選項，則表示根據系統時鐘來更新RTC時間。
.RE
.PP
\fB\-H\fR, \fB\-\-host=\fR
.RS 4
操作指定的遠程主機。可以僅指定一個主機名(hostname)， 也可以使用
"username@hostname"
格式。 hostname 後面還可以加上容器名(以冒號分隔)， 也就是形如
"hostname:container"
的格式， 以表示直接連接到指定主機的指定容器內。 操作將通過SSH協議進行，以確保安全。 可以通過
\fBmachinectl \-H \fR\fB\fIHOST\fR\fR
命令列出遠程主機上的所有容器名稱。
.RE
.PP
\fB\-M\fR, \fB\-\-machine=\fR
.RS 4
在本地容器內執行操作。 必須明確指定容器的名稱。
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
顯示簡短的幫助信息並退出。
.RE
.PP
\fB\-\-version\fR
.RS 4
顯示簡短的版本信息並退出。
.RE
.PP
\fB\-\-no\-pager\fR
.RS 4
不將程序的輸出內容管道(pipe)給分頁程序。
.RE
.PP
能夠識別的命令如下：
.PP
\fBstatus\fR
.RS 4
顯示系統時鐘與RTC的當前狀態， 包括時區設置與網絡時間同步服務的狀態。 注意，所謂"網絡時間同步服務的狀態"實際上只是
systemd\-timesyncd\&.service
服務的狀態， 並不檢查是否存在其他時間同步服務。 這是默認命令。
.RE
.PP
\fBset\-time [TIME]\fR
.RS 4
將系統時鐘設爲指定的時間， 並同時更新RTC時間。 [TIME] 是一個形如 "2012\-10\-30 18:17:16"的時間字符串。
.RE
.PP
\fBset\-timezone [TIMEZONE]\fR
.RS 4
設置系統時區，也就是更新
/etc/localtime
軟連接的指向。 可以用下面的
\fBlist\-timezones\fR
命令列出所有可用時區。 如果RTC被設爲本地時間， 此命令還會同時更新RTC時間。 詳見
\fBlocaltime\fR(5)
手冊。
.RE
.PP
\fBlist\-timezones\fR
.RS 4
列出所有可用時區，每行一個。 列出的值可以用作前述
\fBset\-timezone\fR
命令的參數。
.RE
.PP
\fBset\-local\-rtc [BOOL]\fR
.RS 4
設爲
"no"
表示在RTC中存儲UTC時間； 設爲
"yes"
表示在RTC中存儲本地時間。 應該盡一切可能在RTC中存儲UTC時間。 儘量不要在RTC中存儲本地時間， 因爲這會造成一系列麻煩， 尤其是在切換時區以及調整夏令時或冬令時的時候。 注意，除非明確使用了
\fB\-\-adjust\-system\-clock\fR
選項， 否則此命令還會同時用系統時鐘更新RTC時間。 此命令還會改變
/etc/adjtime
文件第三行的內容，詳見
\fBhwclock\fR(8)
手冊。
.RE
.PP
\fBset\-ntp [BOOL]\fR
.RS 4
是否開啓網絡時間同步。 設爲
"yes"
則啓用並啓動
systemd\-timesyncd\&.service
服務， 設爲
"no"
則停止並停用它。 該命令除了控制
systemd\-timesyncd\&.service
服務的狀態，不做任何其他操作。 也就是說，設爲
"yes"
相當於執行
\fBsystemctl enable \-\-now systemd\-timesyncd\&.service\fR
命令； 而設爲
"no"
則相當於執行
\fBsystemctl disable \-\-now systemd\-timesyncd\&.service\fR
命令；
.sp
注意，即使使用此命令關閉了
systemd\-timesyncd\&.service
服務， 仍然有可能存在其他時間同步服務。 另外，嚴格來說，
systemd\-timesyncd\&.service
除了同步時間之外，還同時兼有其他功能， 例如在無網絡且無RTC的系統上維持系統的"單調時鐘"。 詳見
\fBsystemd-timesyncd.service\fR(8)
手冊。
.RE
.SH "退出狀態"
.PP
返回值爲 0 表示成功， 非零返回值表示失敗代碼。
.SH "環境變量"
.PP
\fI$SYSTEMD_PAGER\fR
.RS 4
指定分頁程序。僅在未指定
\fB\-\-no\-pager\fR
選項時有意義。 此變量會覆蓋
\fI$PAGER\fR
的值。 將此變量設爲空字符串或
"cat"
等價於使用
\fB\-\-no\-pager\fR
選項。
.RE
.PP
\fI$SYSTEMD_LESS\fR
.RS 4
用於覆蓋 默認傳遞給
\fBless\fR
程序的命令行選項 ("FRSXMK")。
.RE
.SH "例子"
.PP
顯示當前的時間設置
.sp
.if n \{\
.RS 4
.\}
.nf
$ 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
.fi
.if n \{\
.RE
.\}
.PP
開啓網絡時間同步服務
.sp
.if n \{\
.RS 4
.\}
.nf
$ 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 ===
.fi
.if n \{\
.RE
.\}
.sp

.sp
.if n \{\
.RS 4
.\}
.nf
$ 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
\&.\&.\&.
.fi
.if n \{\
.RE
.\}
.sp
.SH "參見"
.PP
\fBsystemd\fR(1),
\fBhwclock\fR(8),
\fBdate\fR(1),
\fBlocaltime\fR(5),
\fBsystemctl\fR(1),
\fBsystemd-timedated.service\fR(8),
\fBsystemd-timesyncd.service\fR(8),
\fBsystemd-firstboot\fR(1)
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.PP
翻譯人員：金步國
.br
金步國作品集：http://www.jinbuguo.com
.br
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR