Seth Woolley's Man Viewer

date(1) - date, date - print or set the system date and time - man date

([section] manual, -k keyword, -K [section] search, -f whatis)
man plain no title

DATE(1)                          User Commands                         DATE(1)



NAME
       date - print or set(7,n,1 builtins) the system date and time(1,2,n)

SYNOPSIS
       date [OPTION]... [+FORMAT]
       date [-u|--utc|--universal] [MMDDhhmm[[CC]YY][.ss]]

DESCRIPTION
       Display the current time(1,2,n) in(1,8) the given FORMAT, or set(7,n,1 builtins) the system date.

       -d, --date=STRING
              display time(1,2,n) described by STRING, not `now'

       -f, --file=DATEFILE
              like --date once for each line of DATEFILE

       -ITIMESPEC, --iso-8601[=TIMESPEC]
              output  date/time(1,2,n)  in(1,8) ISO 8601 format.  TIMESPEC=`date' for date
              only, `hours', `minutes', or `seconds' for date and time(1,2,n) to  the
              indicated  precision.   --iso-8601  without TIMESPEC defaults to
              `date'.

       -r, --reference=FILE
              display the last modification time(1,2,n) of FILE

       -R, --rfc-2822
              output RFC-2822 compliant date string(3,n)

       -s, --set=STRING
              set(7,n,1 builtins) time(1,2,n) described by STRING

       -u, --utc, --universal
              print or set(7,n,1 builtins) Coordinated Universal Time

       --help display this help and exit(3,n,1 builtins)

       --version
              output version(1,3,5) information and exit(3,n,1 builtins)

       FORMAT controls the output.  The only valid option for the second  form
       specifies Coordinated Universal Time.  Interpreted sequences are:

       %%     a literal %

       %a     locale(3,5,7)'s abbreviated weekday name (Sun..Sat)

       %A     locale(3,5,7)'s full weekday name, variable length (Sunday..Saturday)

       %b     locale(3,5,7)'s abbreviated month name (Jan..Dec)

       %B     locale(3,5,7)'s full month name, variable length (January..December)

       %c     locale(3,5,7)'s date and time(1,2,n) (Sat Nov 04 12:02:33 EST 1989)

       %C     century  (year  divided  by  100  and  truncated  to an integer)
              [00-99]

       %d     day of month (01..31)

       %D     date (mm/dd/yy)

       %e     day of month, blank padded ( 1..31)

       %F     same as %Y-%m-%d

       %g     the 2-digit year corresponding to the %V week number

       %G     the 4-digit year corresponding to the %V week number

       %h     same as %b

       %H     hour (00..23)

       %I     hour (01..12)

       %j     day of year (001..366)

       %k     hour ( 0..23)

       %l     hour ( 1..12)

       %m     month (01..12)

       %M     minute (00..59)

       %n     a newline

       %N     nanoseconds (000000000..999999999)

       %p     locale(3,5,7)'s upper case AM or PM indicator (blank in(1,8) many locales)

       %P     locale(3,5,7)'s lower case am or pm indicator (blank in(1,8) many locales)

       %r     time(1,2,n), 12-hour (hh:mm:ss [AP]M)

       %R     time(1,2,n), 24-hour (hh:mm)

       %s     seconds since `00:00:00 1970-01-01 UTC' (a GNU extension)

       %S     second (00..60); the 60 is necessary to accommodate a leap  sec-
              ond

       %t     a horizontal tab

       %T     time(1,2,n), 24-hour (hh:mm:ss)

       %u     day of week (1..7);  1 represents Monday

       %U     week number of year with Sunday as first day of week (00..53)

       %V     week number of year with Monday as first day of week (01..53)

       %w     day of week (0..6);  0 represents Sunday

       %W     week number of year with Monday as first day of week (00..53)

       %x     locale(3,5,7)'s date representation (mm/dd/yy)

       %X     locale(3,5,7)'s time(1,2,n) representation (%H:%M:%S)

       %y     last two digits of year (00..99)

       %Y     year (1970...)

       %z     RFC-2822  style  numeric  timezone (-0500) (a nonstandard exten-
              sion)

       %Z     time(1,2,n) zone (e.g., EDT), or nothing if(3,n)  no  time(1,2,n)  zone  is  deter-
              minable

       By  default, date pads numeric fields with zeroes.  GNU date recognizes
       the following modifiers between `%' and a numeric directive.

              `-' (hyphen) do not pad the field `_' (underscore) pad the field
              with spaces

AUTHOR
       Written by David MacKenzie.

REPORTING BUGS
       Report bugs to <bug-coreutils@gnu.org>.

COPYRIGHT
       Copyright  2004 Free Software Foundation, Inc.
       This is free software; see the source for copying conditions.  There is
       NO warranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR
       PURPOSE.

SEE ALSO
       The  full documentation for date is maintained as a Texinfo manual.  If
       the info(1,5,n) and date programs are properly installed  at  your  site,  the
       command

              info(1,5,n) coreutils date

       should give you access(2,5) to the complete manual.



date (coreutils) 5.2.1            March 2004                           DATE(1)

References for this manual (incoming links)