1.\" $NetBSD: zdump.8,v 1.12 2014/08/15 11:04:07 christos Exp $ 2.Dd August 15, 2014 3.Dt ZDUMP 8 4.Os 5.Sh NAME 6.Nm zdump 7.Nd time zone dumper 8.Sh SYNOPSIS 9.Nm zdump 10.Op Fl \-version 11.Op Fl v 12.Op Fl V 13.Op Fl c Ar [loyear,]highyear 14.Op Ar zonename ... 15.Nm zdump 16.Fl t 17.Ar [loyear,]highyear 18.Op Ar zonename ... 19.Sh DESCRIPTION 20.Nm 21prints the current time in each 22.Ar zonename 23named on the command line. 24.Pp 25These options are available: 26.Bl -tag -width XXXXXXXXX -compact 27.It Fl \-version 28Output version information and exit. 29.It Fl v 30For each 31.Ar zonename 32on the command line, 33print the time at the lowest possible time value, 34the time one day after the lowest possible time value, 35the times both one second before and exactly at 36each detected time discontinuity, 37the time at one day less than the highest possible time value, 38and the time at the highest possible time value, 39Each line ends with 40.Dl isdst=1 41if the given time is Daylight Saving Time or 42.Dl isdst=0 43otherwise. 44.It Fl c Ar [loyear,]highyear 45Cut off the verbose output near the start of the given year(s). 46By default, 47the program cuts off verbose output near the starts of the years 48\-500 and 2500. 49.It Fl t Ar [loyear,]highyear 50Cut off verbose output at the start of the given time(s), 51given in decimal seconds since 1970-01-01 00:00:00 UTC. 52.It Fl V 53Like 54.Fl v , 55except omit the times relative to the extreme time values. 56This generates output that is easier to compare to that of 57implementations with different time representations. 58.El 59.Sh LIMITATIONS 60Time discontinuities are found by sampling the results returned by localtime 61at twelve-hour intervals. 62This works in all real-world cases; 63one can construct artificial time zones for which this fails. 64.Pp 65In the output, 66.Dq UT 67denotes the value returned by 68.Xr gmtime 3 , 69which uses UTC for modern time stamps and some other UT flavor for 70time stamps that predate the introduction of UTC. 71No attempt is currently made to have the output use 72.Dq UTC 73for newer and 74.Dq UT 75for older time stamps, 76partly because the exact date of the introduction of UTC is problematic. 77.Sh SEE ALSO 78.Xr ctime 3 , 79.Xr tzfile 5 , 80.Xr zic 8 81.\" @(#)zdump.8 8.2 82.\" This file is in the public domain, so clarified as of 83.\" 2009-05-17 by Arthur David Olson. 84