diff options
Diffstat (limited to 'man8/zdump.8')
| -rw-r--r-- | man8/zdump.8 | 51 |
1 files changed, 25 insertions, 26 deletions
diff --git a/man8/zdump.8 b/man8/zdump.8 index 27d8310ca..f77c0c798 100644 --- a/man8/zdump.8 +++ b/man8/zdump.8 @@ -1,8 +1,6 @@ -.\" %%%LICENSE_START(PUBLIC_DOMAIN) -.\" This page is in the public domain -.\" %%%LICENSE_END -.\" -.TH zdump 8 2020-04-27 "" "Linux System Administration" +.\" This file is in the public domain, so clarified as of +.\" 2009-05-17 by Arthur David Olson. +.TH zdump 8 "" "Time Zone Database" .SH NAME zdump \- timezone dumper .SH SYNOPSIS @@ -13,15 +11,15 @@ zdump \- timezone dumper .I timezone \&... ] .SH DESCRIPTION -.ie '\[lq]'' .ds lq \&"\" -.el .ds lq \[lq]\" -.ie '\[rq]'' .ds rq \&"\" -.el .ds rq \[rq]\" +.ie '\(lq'' .ds lq \&"\" +.el .ds lq \(lq\" +.ie '\(rq'' .ds rq \&"\" +.el .ds rq \(rq\" .de q \\$3\*(lq\\$1\*(rq\\$2 .. -.ie \n(.g .ds - \f(CW-\fP -.el ds - \- +.ie \n(.g .ds - \f(CR-\fP +.el .ds - \- The .B zdump program prints the current time in each @@ -48,12 +46,14 @@ Output a verbose description of time intervals. For each .I timezone on the command line, -print the time at the lowest possible time value, -the time one day after the lowest possible time value, +print the times at the two extreme time values, +the times (if present) at and just beyond the boundaries of years that +.BR localtime (3) +and +.BR gmtime (3) +can represent, and the times both one second before and exactly at -each detected time discontinuity, -the time at one day less than the highest possible time value, -and the time at the highest possible time value. +each detected time discontinuity. Each line is followed by .BI isdst= D where @@ -70,7 +70,7 @@ seconds east of Greenwich. .B \*-V Like .BR \*-v , -except omit the times relative to the extreme time values. +except omit output concerning extreme time and year values. This generates output that is easier to compare to that of implementations with different time representations. .TP @@ -79,10 +79,10 @@ Cut off interval output at the given year(s). Cutoff times are computed using the proleptic Gregorian calendar with year 0 and with Universal Time (UT) ignoring leap seconds. Cutoffs are at the start of each year, where the lower-bound -timestamp is exclusive and the upper is inclusive; for example, +timestamp is inclusive and the upper is exclusive; for example, .B "\*-c 1970,2070" -selects transitions after 1970-01-01 00:00:00 UTC -and on or before 2070-01-01 00:00:00 UTC. +selects transitions on or after 1970-01-01 00:00:00 UTC +and before 2070-01-01 00:00:00 UTC. The default cutoff is .BR \*-500,2500 . .TP @@ -95,7 +95,7 @@ The determines whether the count includes leap seconds. As with .BR \*-c , -the cutoff's lower bound is exclusive and its upper bound is inclusive. +the cutoff's lower bound is inclusive and its upper bound is exclusive. .SH "INTERVAL FORMAT" The interval format is a compact text representation that is intended to be both human- and machine-readable. It consists of an empty line, @@ -151,7 +151,7 @@ Here is an example of the output, with the leading empty line omitted. tabbed columns line up.) .nf .sp -.if \n(.g .ft CW +.if \n(.g .ft CR .if t .in +.5i .if n .in +2 .nr w \w'1896-01-13 'u+\n(.i @@ -184,7 +184,7 @@ UT, a standard time abbreviated HST. Here are excerpts from another example: .nf .sp -.if \n(.g .ft CW +.if \n(.g .ft CR .if t .in +.5i .if n .in +2 TZ="Europe/Astrakhan" @@ -204,7 +204,8 @@ This time zone is east of UT, so its UT offsets are positive. Also, many of its time zone abbreviations are omitted since they duplicate the text of the UT offset. .SH LIMITATIONS -Time discontinuities are found by sampling the results returned by localtime +Time discontinuities are found by sampling the results returned by +.BR localtime (3) at twelve-hour intervals. This works in all real-world cases; one can construct artificial time zones for which this fails. @@ -228,5 +229,3 @@ introduction of UTC is problematic. .SH SEE ALSO .BR tzfile (5), .BR zic (8) -.\" This file is in the public domain, so clarified as of -.\" 2009-05-17 by Arthur David Olson. |