man/man1/date.1

   1 .TH DATE 1
   2 .SH NAME
   3 date \- print or set the date and time
   4 .SH SYNOPSIS
   5 \fBdate [\fB\-qsuS\fR] [\fB\-r\fI seconds\fR]
   6 [[\fIMMDDYY\fR]\fIhhmm\fR[\fIss\fR]] [\fI+format\fR]\fR
   7 .br
   8 .de FL
   9 .TP
  10 \\fB\\$1\\fR
  11 \\$2
  12 ..
  13 .de EX
  14 .TP 20
  15 \\fB\\$1\\fR
  16 # \\$2
  17 ..
  18 .SH OPTIONS
  19 .FL "\-q" "Read the date from \fIstdin\fR"
  20 .FL "\-s" "Set the time (implicit for \fB\-q\fR or a date string)"
  21 .FL "\-u" "Print the date as GMT"
  22 .FL "\-S" "Date within Eternal September"
  23 .FL "\-r" "Use this number of seconds instead of current time"
  24 .SH EXAMPLES
  25 .EX "date" "Print the date and time"
  26 .EX "date 0221921610" "Set date to Feb 21, 1992 at 4:10 p.m."
  27 .SH DESCRIPTION
  28 .PP
  29 With the \fB\-q\fR flag or a numeric argument,
  30 .I date
  31 sets the GMT time and date.
  32 .I MMDDYY
  33 refers to the month, day, and year;
  34 .I hhmmss
  35 refers to the hour, minute and second.
  36 Each of the six fields must be exactly two digits, no more and no less.
  37 .I date
  38 always display the date and time, with the default format for the system.
  39 The \fB\-u\fR flag request GMT time instead of local time.
  40 A format may be specified with a + followed by a printf-like string with
  41 the following options:
  42 .ta 0.25i
  43 .nf
  44 .PP
  45         %%  % character
  46         %A  Name of the day
  47         %B  Name of the month
  48         %D  mm/dd/yy
  49         %H  Decimal hour on 2 digits
  50         %I  Decimal hour modulo 12 on 2 digits
  51         %M  Decimal minute on 2 digits
  52         %S  Decimal seconds on 2 digits
  53         %T  HH:MM:SS
  54         %U  Decimal week number, Sunday being first day of week
  55         %W  Decimal week number, Monday being first day of week
  56         %X  Same as %T
  57         %Y  Decimal year on 4 digits
  58         %Z  Time Zone (if any)
  59         %a  Abbreviated name of the day
  60         %b  Abbreviated name of the month
  61         %c  Appropriate date & time (default format)
  62         %d  Decimal day of the month on 2 digits
  63         %e  Same as %d, but a space replaces leading 0
  64         %h  Same as %b
  65         %j  Decimal dey of the year on 3 digits
  66         %m  Decimal month on 2 digits
  67         %n  Newline character
  68         %p  AM or PM
  69         %r  12-hour clock time with AM/PM
  70         %s  Number of seconds since the epoch
  71         %t  Tab character
  72         %w  Decimal day of the week (0=Sunday)
  73         %x  Same as %D
  74         %y  Decimal year on 2 digits
  75 .SH "SEE ALSO"
  76 .BR time (2),
  77 .BR ctime (3),
  78 .BR readclock (8).