Differences between current version and predecessor to the previous major change of date(1).
Other diffs: Previous Revision, Previous Author, or view the Annotated Edit History
Newer page: | version 4 | Last edited on Monday, October 15, 2007 3:55:06 pm | by IanMcDonald | |
Older page: | version 3 | Last edited on Wednesday, September 10, 2003 8:32:13 pm | by GreigMcGill | Revert |
@@ -1,342 +1,167 @@
-DATE
-!!!DATE
+<verbatim>
NAME
+ date - print or set the system date and time
+
SYNOPSIS
+ date [OPTION]... [+FORMAT]
+ date [-u|--utc|--universal] [MMDDhhmm[[CC]YY][.ss]]
+
DESCRIPTION
-AUTHOR
-REPORTING BUGS
-COPYRIGHT
-SEE ALSO
-----
-!!NAME
+ Display the current time in the given FORMAT, or set the system date.
+ -d, --date=STRING
+ display time described by STRING, not ‘now’
-date
- print or set the system date and time
-!!SYNOPSIS
+
-f, --file=DATEFILE
+ like --date once for each line of DATEFILE
+ -r, --reference=FILE
+ display the last modification time of FILE
-__date__ [[''OPTION'']... [[''+FORMAT'']__
-date__ [[''
-u|
--utc|
--universal'']
-[[''MMDDhhmm''[[[[''CC'']''YY''][[''.ss'']]
-!!DESCRIPTION
+
-R,
--rfc
-2822
+ output date and time in RFC 2822 format
+ --rfc-3339=TIMESPEC
+ output date and time in RFC 3339 format. TIMESPEC=‘date’, ‘sec‐
+ onds’, or ‘ns’ for date and time to the indicated precision.
-Display the current time in the given FORMAT
, or
set the
-system date.
+ -s
, --
set=STRING
+ set time described by STRING
+ -u, --utc, --universal
+ print or set Coordinated Universal Time
-__
-d__, __
--date__=''STRING''
+
--help display this help and exit
+ --version
+ output version information and exit
-display time described by STRING, not `now'
+ FORMAT controls the output. The only valid option for the second form
+ specifies Coordinated Universal Time. Interpreted sequences are:
+ %% a literal %
-__-f__
, __--file__=''DATEFILE''
+ %a locale’s abbreviated weekday name (e.g.
, Sun)
+ %A locale’s full weekday name (e.g., Sunday)
-like __--date__ once for each line of
-DATEFILE
+ %b locale’s abbreviated month name (e.g., Jan)
+ %B locale’s full month name (e.g., January)
-__-I__, __--iso-8601__[[=''TIMESPEC''] output an
-ISO-8601 compliant
date/
time string
.
+ %c locale’s
date and
time (e
.g., Thu Mar 3 23:05:25 2005)
+ %C century; like %Y, except omit last two digits (e.g., 21)
-TIMESPEC=`date'
(or missing
) for date only, `hours',
-`minutes', or `seconds' for date and time to the indicated
-precision.
+ %d day of month
(e.g, 01
)
+ %D date; same as %m/%d/%y
-__-r__
, __--reference__=''FILE''
+ %e day of month
, space padded; same as %
_d
+ %F full date; same as %Y-%m-%d
-display the
last modification time
of FILE
+ %g
last two digits
of year of ISO week number (see %G)
+ %G year of ISO week number (see %V); normally useful only with %V
-__-R__, __--rfc-822__
+ %h same as %b
+ %H hour (00..23)
-output RFC-822 compliant date string
+ %I hour (01..12)
+ %j day of year (001..366)
-__-s__, __--set__=''STRING''
+ %k hour ( ..23)
+ %l hour ( 1..12)
-set time described by STRING
+ %m month (01..12)
+ %M minute (00..59)
-__-u__, __--utc__, __--universal__
+ %n a newline
+ %N nanoseconds (000000000..999999999)
-print
or set Coordinated Universal Time
+ %p locale’s equivalent of either AM
or PM; blank if not known
+ %P like %p, but lower case
-__
--help__
+ %r locale’s 12
-hour clock time (e.g., 11:11:04 PM)
+ %R 24-hour hour and minute; same as %H:%M
-display this help and exit
+ %s seconds since 1970-01-01 00:00:00 UTC
+ %S second (00..60)
-__--version__
+ %t a tab
+ %T time; same as %H:%M:%S
-output version information and exit
+ %u day of week (1..7); 1 is Monday
+ %U week number of year, with Sunday as first day of week (00..53)
-FORMAT controls the output
. The only valid option for the
-second form specifies Coordinated Universal Time
.
-Interpreted sequences are:
+ %V ISO week number, with Monday as first day of week (01
..53)
+ %w day of week (0..6); 0 is Sunday
-%%
+
%W week number of year, with Monday as first day of week (00..53)
+ %x locale’s date representation (e.g., 12/31/99)
-a literal
%
+
%X locale’s time representation (e.g., 23:13:48)
+ %y last two digits of year (00..99)
-%a
+
%Y year
+ %z +hhmm numeric timezone (e.g., -0400)
-locale's abbreviated weekday name
(Sun
..Sat
)
+ %:z +hh:mm numeric timezone
(e
.g
., -04:00
)
+ %::z +hh:mm:ss numeric time zone (e.g., -04:00:00)
-%A
+
%:::z numeric time zone with : to necessary precision (e.g., -04,
+ +05:30)
+ %Z alphabetic time zone abbreviation (e.g., EDT)
-locale's full weekday name
, variable length
-(Sunday..Saturday)
+ By default
, date pads numeric fields with zeroes. The following
+ optional flags may follow ‘%’:
+ - (hyphen) do not pad the field _ (underscore) pad with spaces 0
+ (zero) pad with zeros ^ use upper case if possible # use oppo‐
+ site case if possible
-%b
+ 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 alter‐
+ nate representations if available, or O to use the locale’s alternate
+ numeric symbols if available.
+AUTHOR
+ Written by David MacKenzie.
-locale's abbreviated month name (Jan
..Dec)
+REPORTING BUGS
+ Report bugs to <bug-coreutils@gnu
.org>
.
+COPYRIGHT
+ Copyright © 2006 Free Software Foundation, Inc.
+ This is free software. You may redistribute copies of it under the
+ terms of the GNU General Public License
+ <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the
+ extent permitted by law.
-%B
-
-
-locale's full month name, variable length
-(January..December)
-
-
-%c
-
-
-locale's date and time (Sat Nov 04 12:02:33 EST
-1989)
-
-
-%d
-
-
-day of month (01..31)
-
-
-%D
-
-
-date (mm/dd/yy)
-
-
-%e
-
-
-day of month, blank padded ( 1..31)
-
-
-%h
-
-
-same as %b
-
-
-%H
-
-
-hour (00..23)
-
-
-%I
-
-
-hour (01..12)
-
-
-%j
-
-
-day of year (001..366)
-
-
-%k
-
-
-hour ( ..23)
-
-
-%l
-
-
-hour ( 1..12)
-
-
-%m
-
-
-month (01..12)
-
-
-%M
-
-
-minute (00..59)
-
-
-%n
-
-
-a newline
-
-
-%p
-
-
-locale's AM or PM
-
-
-%r
-
-
-time, 12-hour (hh:mm:ss [[AP]M)
-
-
-%s
-
-
-seconds since `00:00:00 1970-01-01 UTC' (a GNU
-extension)
-
-
-%S
-
-
-second (00..60)
-
-
-%t
-
-
-a horizontal tab
-
-
-%T
-
-
-time, 24-hour (hh:mm:ss)
-
-
-%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 (..6); 0 represents Sunday
-
-
-%W
-
-
-week number of year with Monday as first day of week
-(00..53)
-
-
-%x
-
-
-locale's date representation (mm/dd/yy)
-
-
-%X
-
-
-locale's time representation (%H:%M:%S)
-
-
-%y
-
-
-last two digits of year (00..99)
-
-
-%Y
-
-
-year (1970...)
-
-
-%z
-
-
-RFC-822 style numeric timezone (-0500) (a nonstandard
-extension)
-
-
-%Z
-
-
-time zone (e.g., EDT), or nothing if no time zone is
-determinable
-
-
-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
-!!COPYRIGHT
-
-
-Copyright 2000 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__
and __
date__
programs
-
are properly installed at your site, the
-command
-
-
-__info date__
+SEE ALSO
+
The
full documentation for date is maintained as a Texinfo manual.
If
+
the info and date programs are properly installed
at
your
site,
the
+
command
+ info date
-should give you access to the complete manual.
-----
+
should give you access to the complete manual.
-See also: 822-date(1)
+</verbatim>