129 lines
6 KiB
Text
129 lines
6 KiB
Text
|
NAME
|
||
|
|
|
||
|
|
date - show and set date and time
|
||
|
|
|
||
|
|
SYNOPSIS
|
||
|
|
date [ -u ] [ -c ] [ -n ] [ -d dsttype ] [ -t minutes-west ]
|
||
|
|
[ -a [+|-]sss.fff ] [ +format ] [ [yyyy]mmddhhmm[yy][.ss] ]
|
||
|
|
|
||
|
|
DESCRIPTION
|
||
|
|
Date without arguments writes the date and time to the
|
||
|
|
standard output in the form
|
||
|
|
Wed Mar 8 14:54:40 EST 1989
|
||
|
|
with EST replaced by the local time zone's abbreviation (or
|
||
|
|
by the abbreviation for the time zone specified in the TZ
|
||
|
|
environment variable if set). The exact output format
|
||
|
|
depends on the locale.
|
||
|
|
|
||
|
|
If a command-line argument starts with a plus sign (`+'),
|
||
|
|
the rest of the argument is used as a format that controls
|
||
|
|
what appears in the output. In the format, when a percent
|
||
|
|
sign (`%') appears, it and the character after it are not
|
||
|
|
output, but rather identify part of the date or time to be
|
||
|
|
output in a particular way (or identify a special character
|
||
|
|
to output):
|
||
|
|
|
||
|
|
Sample output Explanation
|
||
|
|
%a Wed Abbreviated weekday name*
|
||
|
|
%A Wednesday Full weekday name*
|
||
|
|
%b Mar Abbreviated month name*
|
||
|
|
%B March Full month name*
|
||
|
|
%c Wed Mar 08 14:54:40 1989 Date and time*
|
||
|
|
%C 19 Century
|
||
|
|
%d 08 Day of month (always two digits)
|
||
|
|
%D 03/08/89 Month/day/year (eight characters)
|
||
|
|
%e 8 Day of month (leading zero blanked)
|
||
|
|
%h Mar Abbreviated month name*
|
||
|
|
%H 14 24-hour-clock hour (two digits)
|
||
|
|
%I 02 12-hour-clock hour (two digits)
|
||
|
|
%j 067 Julian day number (three digits)
|
||
|
|
%k 2 12-hour-clock hour (leading zero blanked)
|
||
|
|
%l 14 24-hour-clock hour (leading zero blanked)
|
||
|
|
%m 03 Month number (two digits)
|
||
|
|
%M 54 Minute (two digits)
|
||
|
|
%n \n newline character
|
||
|
|
%p PM AM/PM designation
|
||
|
|
%r 02:54:40 PM Hour:minute:second AM/PM designation
|
||
|
|
%R 14:54 Hour:minute
|
||
|
|
%S 40 Second (two digits)
|
||
|
|
%t \t tab character
|
||
|
|
%T 14:54:40 Hour:minute:second
|
||
|
|
%U 10 Sunday-based week number (two digits)
|
||
|
|
%w 3 Day number (one digit, Sunday is 0)
|
||
|
|
%W 10 Monday-based week number (two digits)
|
||
|
|
%x 03/08/89 Date*
|
||
|
|
%X 14:54:40 Time*
|
||
|
|
%y 89 Last two digits of year
|
||
|
|
%Y 1989 Year in full
|
||
|
|
%Z EST Time zone abbreviation
|
||
|
|
%+ Wed Mar 8 14:54:40 EST 1989 Default output format*
|
||
|
|
* The exact output depends on the locale.
|
||
|
|
|
||
|
|
If a character other than one of those shown above appears
|
||
|
|
after a percent sign in the format, that following character
|
||
|
|
is output. All other characters in the format are copied
|
||
|
|
unchanged to the output; a newline character is always added
|
||
|
|
at the end of the output.
|
||
|
|
|
||
|
|
In Sunday-based week numbering, the first Sunday of the year
|
||
|
|
begins week 1; days preceding it are part of ``week 0.'' In
|
||
|
|
Monday-based week numbering, the first Monday of the year
|
||
|
|
begins week 1.
|
||
|
|
|
||
|
|
To set the date, use a command line argument with one of the
|
||
|
|
following forms:
|
||
|
|
1454 24-hour-clock hours (first two digits) and minutes
|
||
|
|
081454 Month day (first two digits), hours, and minutes
|
||
|
|
03081454 Month (two digits, January is 01), month day, hours, minutes
|
||
|
|
8903081454 Year, month, month day, hours, minutes
|
||
|
|
0308145489 Month, month day, hours, minutes, year
|
||
|
|
(on System V-compatible systems)
|
||
|
|
030814541989 Month, month day, hours, minutes, four-digit year
|
||
|
|
198903081454 Four-digit year, month, month day, hours, minutes
|
||
|
|
If the century, year, month, or month day is not given, the
|
||
|
|
current value is used. Any of the above forms may be
|
||
|
|
followed by a period and two digits that give the seconds
|
||
|
|
part of the new time; if no seconds are given, zero is
|
||
|
|
assumed.
|
||
|
|
|
||
|
|
These options are available:
|
||
|
|
|
||
|
|
-u or -c
|
||
|
|
Use UTC when setting and showing the date and time.
|
||
|
|
|
||
|
|
-n Do not notify other networked systems of the time
|
||
|
|
change.
|
||
|
|
|
||
|
|
-d dsttype
|
||
|
|
Set the kernel-stored Daylight Saving Time type to the
|
||
|
|
given value. (The kernel-stored DST type is used
|
||
|
|
mostly by ``old'' binaries.)
|
||
|
|
|
||
|
|
-t minutes-west
|
||
|
|
Set the kernel-stored ``minutes west of UTC'' value to
|
||
|
|
the one given on the command line. (The kernel-stored
|
||
|
|
DST type is used mostly by ``old'' binaries.)
|
||
|
|
|
||
|
|
-a adjustment
|
||
|
|
Change the time forward (or backward) by the number of
|
||
|
|
seconds (and fractions thereof) specified in the
|
||
|
|
adjustment argument. Either the seconds part or the
|
||
|
|
fractions part of the argument (but not both) may be
|
||
|
|
omitted. On BSD-based systems, the adjustment is made
|
||
|
|
by changing the rate at which time advances; on
|
||
|
|
System-V-based systems, the adjustment is made by
|
||
|
|
changing the time.
|
||
|
|
|
||
|
|
FILES
|
||
|
|
/usr/lib/locale/L/LC_TIME description of time
|
||
|
|
locale L
|
||
|
|
/usr/local/etc/zoneinfo time zone information
|
||
|
|
directory
|
||
|
|
/usr/local/etc/zoneinfo/localtime local time zone file
|
||
|
|
/usr/local/etc/zoneinfo/posixrules used with POSIX-style
|
||
|
|
TZ's
|
||
|
|
/usr/local/etc/zoneinfo/GMT for UTC leap seconds
|
||
|
|
|
||
|
|
If /usr/local/etc/zoneinfo/GMT is absent, UTC leap seconds
|
||
|
|
are loaded from /usr/local/etc/zoneinfo/posixrules.
|