.\" 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