mirror of
https://frontier.innolan.net/rainlance/amiga-tz.git
synced 2025-11-21 05:53:37 +00:00
42801d2b1f
In several places the code and documentation incorrectly used "UTC" to describe time stamps that might precede the introduction of UTC and for which UTC is therefore undefined. Change these uses to "UT", as that's the correct term when talking about these time stamps. Problem reported by Steve Allen in <http://mm.icann.org/pipermail/tz/2013-September/019907.html>. The major compatibility issue here is with 'zdump -v'; it'll now output "UT" instead of the possibly-incorrect "UTC". Many files change in minor ways in the commentary. * zdump.c (show): * zic.c (inzsub, addtype): In output, say "UT" rather than "UTC", since the time stamp we're talking about might precede the introduction of UTC.
188 lines
5.3 KiB
Groff
188 lines
5.3 KiB
Groff
.TH DATE 1
|
|
.SH NAME
|
|
date \- show and set date and time
|
|
.SH SYNOPSIS
|
|
.if n .nh
|
|
.if n .na
|
|
.B date
|
|
[
|
|
.B \-u
|
|
] [
|
|
.B \-c
|
|
] [
|
|
.B \-r
|
|
seconds
|
|
] [
|
|
.B \-n
|
|
] [
|
|
.B \-d
|
|
dsttype
|
|
] [
|
|
.B \-t
|
|
minutes-west
|
|
] [
|
|
\fB\-a \fR[\fB+\fR|\fB-]\fIsss\fB.\fIfff\fR
|
|
] [
|
|
.BI + format
|
|
] [
|
|
\fR[\fIyyyy\fR]\fImmddhhmm\fR[\fIyy\fR][\fB.\fIss\fR]
|
|
]
|
|
.SH DESCRIPTION
|
|
.I Date
|
|
without arguments writes the date and time to the standard output in
|
|
the form
|
|
.ce 1
|
|
Wed Mar 8 14:54:40 EST 1989
|
|
.br
|
|
with
|
|
.B EST
|
|
replaced by the local time zone's abbreviation
|
|
(or by the abbreviation for the time zone specified in the
|
|
.B TZ
|
|
environment variable if set).
|
|
The exact output format depends on the locale.
|
|
.PP
|
|
If a command-line argument starts with a plus sign
|
|
.RB (` + '),
|
|
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 (` % ')
|
|
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):
|
|
.nf
|
|
.sp
|
|
.if t .in +.5i
|
|
.if n .in +2
|
|
.ta \w'%M\0\0'u +\w'Wed Mar 8 14:54:40 EST 1989\0\0'u
|
|
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*
|
|
.if t .in -.5i
|
|
.if n .in -2
|
|
* The exact output depends on the locale.
|
|
.sp
|
|
.fi
|
|
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.
|
|
.PP
|
|
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.
|
|
.PP
|
|
To set the date, use a command line argument with one of the following forms:
|
|
.nf
|
|
.if t .in +.5i
|
|
.if n .in +2
|
|
.ta \w'198903081454\0'u
|
|
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 t .in -.5i
|
|
.if n .in -2
|
|
.fi
|
|
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.
|
|
.PP
|
|
These options are available:
|
|
.TP
|
|
.BR \-u " or " \-c
|
|
Use Universal Time when setting and showing the date and time.
|
|
.TP
|
|
.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.
|
|
.TP
|
|
.B \-n
|
|
Do not notify other networked systems of the time change.
|
|
.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.
|
|
.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
|
|
.br
|
|
/usr/local/etc/zoneinfo time zone information directory
|
|
.br
|
|
/usr/local/etc/zoneinfo/localtime local time zone file
|
|
.br
|
|
/usr/local/etc/zoneinfo/posixrules used with POSIX-style TZ's
|
|
.br
|
|
/usr/local/etc/zoneinfo/GMT for UTC leap seconds
|
|
.sp
|
|
If
|
|
.B /usr/local/etc/zoneinfo/GMT
|
|
is absent,
|
|
UTC leap seconds are loaded from
|
|
.BR /usr/local/etc/zoneinfo/posixrules .
|
|
.\" This file is in the public domain, so clarified as of
|
|
.\" 2009-05-17 by Arthur David Olson.
|