diff options
Diffstat (limited to 'date.1')
| -rw-r--r-- | date.1 | 90 |
1 files changed, 40 insertions, 50 deletions
@@ -4,28 +4,32 @@ date \- show and set date and time .SH SYNOPSIS .if n .nh .if n .na +.ie \n(.g .ds - \f(CW-\fP +.el .ds - \- .B date [ -.B \-u +.B \*-u ] [ -.B \-c +.B \*-c ] [ -.B \-n -] [ -.B \-d -dsttype -] [ -.B \-t -minutes-west -] [ -\fB\-a \fR[\fB+\fR|\fB-]\fIsss\fB.\fIfff\fR +.B \*-r +.I seconds ] [ .BI + format ] [ \fR[\fIyyyy\fR]\fImmddhhmm\fR[\fIyy\fR][\fB.\fIss\fR] ] .SH DESCRIPTION -.I Date +.ie '\(lq'' .ds lq \&"\" +.el .ds lq \(lq\" +.ie '\(rq'' .ds rq \&"\" +.el .ds rq \(rq\" +.de q +\\$3\*(lq\\$1\*(rq\\$2 +.. +The +.B date +command without arguments writes the date and time to the standard output in the form .ce 1 @@ -39,13 +43,13 @@ replaced by the local time zone's abbreviation environment variable if set). The exact output format depends on the locale. .PP -If a command-line argument starts with a plus sign -.RB (` + '), +If a command-line argument starts with a plus sign (\c +.q "\fB+\fP" ), the rest of the argument is used as a .I format that controls what appears in the output. -In the format, when a percent sign -.RB (` % ') +In the format, when a percent sign (\c +.q "\fB%\fP" appears, it and the character after it are not output, but rather identify part of the date or time @@ -88,6 +92,7 @@ to be output in a particular way %X 14:54:40 Time* %y 89 Last two digits of year %Y 1989 Year in full +%z -0500 Numeric time zone %Z EST Time zone abbreviation %+ Wed Mar 8 14:54:40 EST 1989 Default output format* .if t .in -.5i @@ -103,7 +108,8 @@ a newline character is always added at the end of the output. .PP In Sunday-based week numbering, the first Sunday of the year begins week 1; -days preceding it are part of ``week 0.'' +days preceding it are part of +.q "week 0" . In Monday-based week numbering, the first Monday of the year begins week 1. .PP @@ -130,48 +136,32 @@ the seconds part of the new time; if no seconds are given, zero is assumed. .PP These options are available: .TP -.BR \-u " or " \-c -Use UTC when setting and showing the date and time. -.TP -.B \-n -Do not notify other networked systems of the time change. +.BR \*-u " or " \*-c +Use Universal Time when setting and showing the date and time. .TP -.BI "\-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.) -.TP -.BI "\-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.) -.TP -.BI "\-a " adjustment -Change the time forward (or backward) by the number of seconds -(and fractions thereof) specified in the -.I 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. +.BI "\*-r " seconds +Output the date that corresponds to +.I seconds +past the epoch of 1970-01-01 00:00:00 UTC, where +.I seconds +should be an integer, either decimal, octal (leading 0), or +hexadecimal (leading 0x), preceded by an optional sign. .SH FILES -.ta \w'/usr/local/etc/zoneinfo/posixrules\0\0'u -/usr/lib/locale/\f2L\fP/LC_TIME description of time locale \f2L\fP +.ta \w'/usr/share/zoneinfo/posixrules\0\0'u +/etc/localtime local timezone file .br -/usr/local/etc/zoneinfo time zone information directory +/usr/lib/locale/\f2L\fP/LC_TIME description of time locale \f2L\fP .br -/usr/local/etc/zoneinfo/localtime local time zone file +/usr/share/zoneinfo timezone information directory .br -/usr/local/etc/zoneinfo/posixrules used with POSIX-style TZ's +/usr/share/zoneinfo/posixrules used with POSIX-style TZ's .br -/usr/local/etc/zoneinfo/GMT for UTC leap seconds +/usr/share/zoneinfo/GMT for UTC leap seconds .sp If -.B /usr/local/etc/zoneinfo/GMT +.B /usr/share/zoneinfo/GMT is absent, UTC leap seconds are loaded from -.BR /usr/local/etc/zoneinfo/posixrules . -.\" @(#)date.1 8.2 +.BR /usr/share/zoneinfo/posixrules . .\" This file is in the public domain, so clarified as of .\" 2009-05-17 by Arthur David Olson. |