.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5.
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH DATE 1 2022年9月 "GNU coreutils 9.1" 使用者命令
.SH 名稱
date \- 輸出或設定系統日期與時間
.SH 概述
\fBdate\fP [\fI\,選項\/\fP]... [\fI\,+格式字串\/\fP]
.br
\fBdate\fP [\fI\,\-u|\-\-utc|\-\-universal\/\fP]
[\fI\,MMDDhhmm\/\fP[[\fI\,CC\/\fP]\fI\,YY\/\fP][\fI\,.ss\/\fP]]
.SH 描述
.\" Add any additional description here
.PP
按照給定的格式字串顯示日期和時間。使用了 \fB\-s\fP 選項或 [MMDDhhmm[[CC]YY][.ss]] 引數時,設定日期和時間。
.PP
必選引數對長短選項同時適用。
.TP
\fB\-d\fP, \fB\-\-date\fP=\fI\,字串\/\fP
顯示由字串指定的時間,而不是當前時間
.TP
\fB\-\-debug\fP
對日期的解析過程進行註解,對不規範的用法進行警告,並輸出到標準錯誤
.TP
\fB\-f\fP, \fB\-\-file\fP=\fI\,日期檔案\/\fP
類似 \fB\-\-date\fP;對日期檔案的每一行執行一次
.TP
\fB\-I[格式]\fP, \fB\-\-iso\-8601\fP[=\fI\,格式\/\fP]
以 ISO 8601 格式輸出日期/時間。格式="date" 時只輸出日期(預設行為),當其為 "hours"、"minutes"、"seconds"
或 "ns" 時則按照所指示的精確度顯示日期和時間。示例:2006\-08\-14T02:34:56\-06:00
.TP
\fB\-\-resolution\fP
輸出時間戳的可用精度 例如:0.000000001
.TP
\fB\-R\fP, \fB\-\-rfc\-email\fP
以 RFC 5322 格式輸出日期與時間。例:Mon, 14 Aug 2006 02:34:56 \fB\-0600\fP
.TP
\fB\-\-rfc\-3339\fP=\fI\,格式\/\fP
以 RFC 3339 格式輸出日期/時間。格式="date"、"seconds" 或
"ns",按照所指示的精確度顯示日期和時間。例如:2006\-08\-14 02:34:56\-06:00
.TP
\fB\-r\fP, \fB\-\-reference\fP=\fI\,檔案\/\fP
顯示指定檔案的最後修改時間
.TP
\fB\-s\fP, \fB\-\-set\fP=\fI\,字串\/\fP
將時間設定為字串所描述的時間
.TP
\fB\-u\fP, \fB\-\-utc\fP, \fB\-\-universal\fP
按照協調世界時 (UTC) 顯示或設定時間
.TP
\fB\-\-help\fP
顯示此幫助資訊並退出
.TP
\fB\-\-version\fP
顯示版本資訊並退出
.PP
格式字串控制輸出格式。支援解釋的序列有:
.TP
%%
一個 % 字元
.TP
%a
當前區域設定的星期幾的縮寫(例如:日)
.TP
%A
當前區域設定的星期幾的全稱(例如:星期日)
.TP
%b
當前區域設定的月份縮寫(例如:1月)
.TP
%B
當前區域設定的月份全稱(例如:一月)
.TP
%c
當前區域設定的日期和時間(例如:2005年03月03日 星期四 23時05分25秒)
.TP
%C
世紀(指年份的最高兩位);類似 %Y,但省略最後兩位數(例如:20)
.TP
%d
日(例如:01)
.TP
%D
日期;等於 %m/%d/%y
.TP
%e
日,以空格填充;等於 %_d
.TP
%F
完整的日期;等於 %+4Y\-%m\-%d
.TP
%g
ISO 週數年的最後兩位(參見 %G)
.TP
%G
ISO 週數年(參見 %V);一般只和 %V 一起使用
.TP
%h
等於 %b
.TP
%H
小時 (00..23)
.TP
%I
小時 (01..12)
.TP
%j
一年中的第幾日 (001..366)
.TP
%k
小時,以空格填充 ( 0..23);等於 %_H
.TP
%l
小時,以空格填充 ( 1..12);等於 %_I
.TP
%m
月 (01..12)
.TP
%M
分鐘 (00..59)
.TP
%n
換行
.TP
%N
納秒 (000000000..999999999)
.TP
%p
當前區域設定中 AM 或 PM 的等價說法("上午" 或 "下午");未知則為空
.TP
%P
類似 %p,但使用小寫
.TP
%q
季度 (1..4)
.TP
%r
當前區域設定中 12 小時制鐘表時間(例如:下午 11時11分04秒)
.TP
%R
24 小時制的小時和分鐘;等於 %H:%M
.TP
%s
自 Epoch (1970\-01\-01 00:00 UTC) 以來的秒數
.TP
%S
秒 (00..60)
.TP
%t
製表符
.TP
%T
時間;等於 %H:%M:%S
.TP
%u
星期幾 (1..7);1 代表星期一
.TP
%U
一年中的第幾周,以週日為每週第一天 (00..53)
.TP
%V
ISO 週數,以週一為每週第一天 (01..53)
.TP
%w
星期幾 (0..6);0 代表星期日
.TP
%W
一年中的第幾周,以週一為每週第一天 (00..53)
.TP
%x
當前區域設定的日期表示法(例如:1999年12月31日)
.TP
%X
當前區域設定的時間表示法(例如:23時13分48秒)
.TP
%y
年的最後兩位 (00..99)
.TP
%Y
年
.TP
%z
+hhmm 數字時區(例如:\fB\-0400\fP)
.TP
%:z
+hh:mm 數字時區(例如:\fB\-04\fP:00)
.TP
%::z
+hh:mm:ss 數字時區(例如:\-04:00:00)
.TP
%:::z
數字時區,精度上有必要時加 ":"(例如:\fB\-04\fP、+05:30)
.TP
%Z
字母時區縮寫(例如:EDT)
.PP
預設情況下,date 輸出的數字欄位以 0 填充。以下可選的標誌可以跟在 "%" 後:
.TP
\-
(連字元)不填充該欄位
.TP
_
(下劃線)以空格填充
.TP
0
(數字 0)以 0 填充
.TP
+
以 0 填充,並且在超過四位數的未來年份之前新增 "+" 符號
.TP
^
如果可能,使用大寫形式
.TP
#
如果可能,使用相反的大小寫
.PP
在任何標誌之後可以有一個可選的欄位寬度,它是一個十進位制數字;然後是一個可選的修飾符,它可以是 E,表示如果可用,使用區域設定的另一種表示法,或者
O,表示如果可用,使用區域設定的另一套數字符號。
.SH 範例
將 Epoch (1970\-01\-01 UTC) 以來的秒數轉換為日期
.IP
\f(CW$ date \-\-date='@2147483647'\fP
.PP
顯示美國西海岸的當前時間(請使用 tzselect(1) 來查詢 TZ 的具體數值)
.IP
\f(CW$ TZ='America/Los_Angeles' date\fP
.PP
顯示美國西海岸下個週五上午 9 時的當地時間
.IP
\f(CW$ date \-\-date='TZ="America/Los_Angeles" 09:00 next Fri'\fP
.SH 日期字串
.\" NOTE: keep this paragraph in sync with the one in touch.x
“\-\-date=字串”選項中的的字串可以是人類易於理解閱讀的日期字串,例如 "Sun, 29 Feb 2004 16:21:42 \-0800" 或
"2004\-02\-29 16:21:42",甚至可以是 "next
Thursday"。一個日期字串可能包含表示日曆日期、一日中的具體時間、時區、星期、相對時間、相對日期和數字的資訊。一個空字串表示當日的起始。日期字串的具體格式較為複雜,在手冊頁中難以簡單描述清楚,但是您可以在
info 文件中找到完整內容。
.SH 作者
由 David MacKenzie 編寫。
.SH 報告錯誤
GNU coreutils 的線上幫助:
.br
請向 報告翻譯錯誤。
.SH 版權
Copyright \(co 2022 Free Software Foundation, Inc. License GPLv3+: GNU GPL
version 3 or later .
.br
本軟體是自由軟體:您可以自由修改和重新發布它。在法律允許的範圍內,不提供任何保證。
.SH 參見
完整文件請見:
.br
或者在本地使用: info \(aq(coreutils) date invocation\(aq
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃:\fBhttps://github.com/man-pages-zh/manpages-zh\fR