.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.012.
.TH DATE "1" "August 1999" "GNU sh-utils 2.0" FSF
.SH NAME
date \- print or set the system date and time
.SH SYNOPSIS
.B date
[\fIOPTION\fR]... [\fI+FORMAT\fR]
.br
.B date
[\fIOPTION\fR] [\fIMMDDhhmm\fR[[\fICC\fR]\fIYY\fR][\fI.ss\fR]]
.SH DESCRIPTION
.PP
.\" Add any additional description here
.PP
Display the current time in the given FORMAT, or set the system date.
.TP
\fB\-d\fR, \fB\-\-date\fR=\fISTRING\fR
display time described by STRING, not `now'
.TP
\fB\-f\fR, \fB\-\-file\fR=\fIDATEFILE\fR
like \fB\-\-date\fR once for each line of DATEFILE
.IP
\fB\-I\fR, \fB\-\-iso\-8601\fR[=\fITIMESPEC\fR] output an ISO-8601 compliant date/time string.
.IP
TIMESPEC=`date' (or missing) for date only,
`hours', `minutes', or `seconds' for date and
time to the indicated precision.
.TP
\fB\-r\fR, \fB\-\-reference\fR=\fIFILE\fR
display the last modification time of FILE
.TP
\fB\-R\fR, \fB\-\-rfc\-822\fR
output RFC-822 compliant date string
.TP
\fB\-s\fR, \fB\-\-set\fR=\fISTRING\fR
set time described by STRING
.TP
\fB\-u\fR, \fB\-\-utc\fR, \fB\-\-universal\fR
print or set Coordinated Universal Time
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
FORMAT controls the output.  The only valid option for the second form
specifies Coordinated Universal Time.  Interpreted sequences are:
.TP
%%
a literal %
.TP
%a
locale's abbreviated weekday name (Sun..Sat)
.TP
%A
locale's full weekday name, variable length (Sunday..Saturday)
.TP
%b
locale's abbreviated month name (Jan..Dec)
.TP
%B
locale's full month name, variable length (January..December)
.TP
%c
locale's date and time (Sat Nov 04 12:02:33 EST 1989)
.TP
%d
day of month (01..31)
.TP
%D
date (mm/dd/yy)
.TP
%e
day of month, blank padded ( 1..31)
.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 ( 0..23)
.TP
%l
hour ( 1..12)
.TP
%m
month (01..12)
.TP
%M
minute (00..59)
.TP
%n
a newline
.TP
%p
locale's AM or PM
.TP
%r
time, 12-hour (hh:mm:ss [AP]M)
.TP
%s
seconds since 00:00:00, Jan 1, 1970 (a GNU extension)
.TP
%S
second (00..60)
.TP
%t
a horizontal tab
.TP
%T
time, 24-hour (hh:mm:ss)
.TP
%U
week number of year with Sunday as first day of week (00..53)
.TP
%V
week number of year with Monday as first day of week (01..52)
.TP
%w
day of week (0..6);  0 represents Sunday
.TP
%W
week number of year with Monday as first day of week (00..53)
.TP
%x
locale's date representation (mm/dd/yy)
.TP
%X
locale's time representation (%H:%M:%S)
.TP
%y
last two digits of year (00..99)
.TP
%Y
year (1970...)
.TP
%z
RFC-822 style numeric timezone (-0500) (a nonstandard extension)
.TP
%Z
time zone (e.g., EDT), or nothing if no time zone is determinable
.PP
By default, date pads numeric fields with zeroes.  GNU date recognizes
the following modifiers between `%' and a numeric directive.
.IP
`-' (hyphen) do not pad the field
`_' (underscore) pad the field with spaces
.SH "REPORTING BUGS"
Report bugs to <bug-sh-utils@gnu.org>.
.SH "SEE ALSO"
The full documentation for
.B date
is maintained as a Texinfo manual.  If the
.B info
and
.B date
programs are properly installed at your site, the command
.IP
.B info date
.PP
should give you access to the complete manual.
.SH COPYRIGHT
Copyright \(co 1999 Free Software Foundation, Inc.
.br
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.