.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.2.
.TH DATE "1" "August 2022" "GNU coreutils 8.32" "User Commands"
.SH NAME
date \- manual page for date 8.32
.SH SYNOPSIS
.B date
[\fI\,OPTION\/\fR]... [\fI\,+FORMAT\/\fR]
.br
.B date
[\fI\,-u|--utc|--universal\/\fR] [\fI\,MMDDhhmm\/\fR[[\fI\,CC\/\fR]\fI\,YY\/\fR][\fI\,.ss\/\fR]]
.SH DESCRIPTION
Display the current time in the given FORMAT, or set the system date.
.PP
Mandatory arguments to long options are mandatory for short options too.
.TP
\fB\-d\fR, \fB\-\-date\fR=\fI\,STRING\/\fR
display time described by STRING, not 'now'
.TP
\fB\-\-debug\fR
annotate the parsed date,
and warn about questionable usage to stderr
.TP
\fB\-f\fR, \fB\-\-file\fR=\fI\,DATEFILE\/\fR
like \fB\-\-date\fR; once for each line of DATEFILE
.TP
\fB\-I[FMT]\fR, \fB\-\-iso\-8601\fR[=\fI\,FMT\/\fR]
output date/time in ISO 8601 format.
FMT='date' for date only (the default),
\&'hours', 'minutes', 'seconds', or 'ns'
for date and time to the indicated precision.
Example: 2006\-08\-14T02:34:56\-06:00
.TP
\fB\-R\fR, \fB\-\-rfc\-email\fR
output date and time in RFC 5322 format.
Example: Mon, 14 Aug 2006 02:34:56 \fB\-0600\fR
.TP
\fB\-\-rfc\-3339\fR=\fI\,FMT\/\fR
output date/time in RFC 3339 format.
FMT='date', 'seconds', or 'ns'
for date and time to the indicated precision.
Example: 2006\-08\-14 02:34:56\-06:00
.TP
\fB\-r\fR, \fB\-\-reference\fR=\fI\,FILE\/\fR
display the last modification time of FILE
.TP
\fB\-s\fR, \fB\-\-set\fR=\fI\,STRING\/\fR
set time described by STRING
.TP
\fB\-u\fR, \fB\-\-utc\fR, \fB\-\-universal\fR
print or set Coordinated Universal Time (UTC)
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
FORMAT controls the output.  Interpreted sequences are:
.TP
%%
a literal %
.TP
%a
locale's abbreviated weekday name (e.g., Sun)
.TP
%A
locale's full weekday name (e.g., Sunday)
.TP
%b
locale's abbreviated month name (e.g., Jan)
.TP
%B
locale's full month name (e.g., January)
.TP
%c
locale's date and time (e.g., Thu Mar  3 23:05:25 2005)
.TP
%C
century; like %Y, except omit last two digits (e.g., 20)
.TP
%d
day of month (e.g., 01)
.TP
%D
date; same as %m/%d/%y
.TP
%e
day of month, space padded; same as %_d
.TP
%F
full date; like %+4Y\-%m\-%d
.TP
%g
last two digits of year of ISO week number (see %G)
.TP
%G
year of ISO week number (see %V); normally useful only with %V
.TP
%h
same as %b
.TP
%H
hour (00..23)
.TP
%I
hour (01..12)
.TP
%j
day of year (001..366)
.TP
%k
hour, space padded ( 0..23); same as %_H
.TP
%l
hour, space padded ( 1..12); same as %_I
.TP
%m
month (01..12)
.TP
%M
minute (00..59)
.TP
%n
a newline
.TP
%N
nanoseconds (000000000..999999999)
.TP
%p
locale's equivalent of either AM or PM; blank if not known
.TP
%P
like %p, but lower case
.TP
%q
quarter of year (1..4)
.TP
%r
locale's 12\-hour clock time (e.g., 11:11:04 PM)
.TP
%R
24\-hour hour and minute; same as %H:%M
.TP
%s
seconds since 1970\-01\-01 00:00:00 UTC
.TP
%S
second (00..60)
.TP
%t
a tab
.TP
%T
time; same as %H:%M:%S
.TP
%u
day of week (1..7); 1 is Monday
.TP
%U
week number of year, with Sunday as first day of week (00..53)
.TP
%V
ISO week number, with Monday as first day of week (01..53)
.TP
%w
day of week (0..6); 0 is Sunday
.TP
%W
week number of year, with Monday as first day of week (00..53)
.TP
%x
locale's date representation (e.g., 12/31/99)
.TP
%X
locale's time representation (e.g., 23:13:48)
.TP
%y
last two digits of year (00..99)
.TP
%Y
year
.TP
%z
+hhmm numeric time zone (e.g., \fB\-0400\fR)
.TP
%:z
+hh:mm numeric time zone (e.g., \fB\-04\fR:00)
.TP
%::z
+hh:mm:ss numeric time zone (e.g., \fB\-04\fR:00:00)
.TP
%:::z
numeric time zone with : to necessary precision (e.g., \fB\-04\fR, +05:30)
.TP
%Z
alphabetic time zone abbreviation (e.g., EDT)
.PP
By default, date pads numeric fields with zeroes.
The following optional flags may follow '%':
.TP
\-
(hyphen) do not pad the field
.TP
_
(underscore) pad with spaces
.TP
0
(zero) pad with zeros
.TP
+
pad with zeros, and put '+' before future years with >4 digits
.TP
^
use upper case if possible
.TP
#
use opposite case if possible
.PP
After any flags comes an optional field width, as a decimal number;
then an optional modifier, which is either
E to use the locale's alternate representations if available, or
O to use the locale's alternate numeric symbols if available.
.SH EXAMPLES
Convert seconds since the epoch (1970\-01\-01 UTC) to a date
.IP
\f(CW$ date --date='@2147483647'\fR
.PP
Show the time on the west coast of the US (use tzselect(1) to find TZ)
.IP
\f(CW$ TZ='America/Los_Angeles' date\fR
.PP
Show the local time for 9AM next Friday on the west coast of the US
.IP
\f(CW$ date --date='TZ="America/Los_Angeles" 09:00 next Fri'\fR
.PP
GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
Report any translation bugs to <https://translationproject.org/team/>
Full documentation <https://www.gnu.org/software/coreutils/date>
or available locally via: info '(coreutils) date invocation'
.SH AUTHOR
Written by David MacKenzie.
.SH COPYRIGHT
Copyright \(co 2020 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.