| 1 |
.\" This file is in the public domain, so clarified as of |
| 2 |
.\" 2009-05-17 by Arthur David Olson. |
| 3 |
.TH tzselect 8 "" "Time Zone Database" |
| 4 |
.SH NAME |
| 5 |
tzselect \- select a timezone |
| 6 |
.SH SYNOPSIS |
| 7 |
.ds d " degrees |
| 8 |
.ds m " minutes |
| 9 |
.ds s " seconds |
| 10 |
.ds _ " \& |
| 11 |
.if t \{\ |
| 12 |
. if \n(.g .if c \(de .if c \(fm .if c \(sd \{\ |
| 13 |
. ds d \(de |
| 14 |
. ds m \(fm |
| 15 |
. ds s \(sd |
| 16 |
. ds _ \| |
| 17 |
. \} |
| 18 |
.\} |
| 19 |
.B tzselect |
| 20 |
[ |
| 21 |
.B \-c |
| 22 |
.I coord |
| 23 |
] [ |
| 24 |
.B \-n |
| 25 |
.I limit |
| 26 |
] [ |
| 27 |
.B \-\-help |
| 28 |
] [ |
| 29 |
.B \-\-version |
| 30 |
] |
| 31 |
.SH DESCRIPTION |
| 32 |
The |
| 33 |
.B tzselect |
| 34 |
program asks the user for information about the current location, |
| 35 |
and outputs the resulting timezone to standard output. |
| 36 |
The output is suitable as a value for the TZ environment variable. |
| 37 |
.PP |
| 38 |
All interaction with the user is done via standard input and standard error. |
| 39 |
.SH OPTIONS |
| 40 |
.TP |
| 41 |
.BI "\-c " coord |
| 42 |
Instead of asking for continent and then country and then city, |
| 43 |
ask for selection from time zones whose largest cities |
| 44 |
are closest to the location with geographical coordinates |
| 45 |
.I coord. |
| 46 |
Use ISO 6709 notation for |
| 47 |
.I coord, |
| 48 |
that is, a latitude immediately followed by a longitude. The latitude |
| 49 |
and longitude should be signed integers followed by an optional |
| 50 |
decimal point and fraction: positive numbers represent north and east, |
| 51 |
negative south and west. Latitudes with two and longitudes with three |
| 52 |
integer digits are treated as degrees; latitudes with four or six and |
| 53 |
longitudes with five or seven integer digits are treated as |
| 54 |
.I "DDMM, DDDMM, DDMMSS," |
| 55 |
or |
| 56 |
.I DDDMMSS |
| 57 |
representing |
| 58 |
.I DD |
| 59 |
or |
| 60 |
.I DDD |
| 61 |
degrees, |
| 62 |
.I MM |
| 63 |
minutes, |
| 64 |
and zero or |
| 65 |
.I SS |
| 66 |
seconds, with any trailing fractions represent fractional minutes or |
| 67 |
(if |
| 68 |
.I SS |
| 69 |
is present) seconds. The decimal point is that of the current locale. |
| 70 |
For example, in the (default) C locale, |
| 71 |
.B "\-c\ +40.689\-074.045" |
| 72 |
specifies 40.689\*d\*_N, 74.045\*d\*_W, |
| 73 |
.B "\-c\ +4041.4\-07402.7" |
| 74 |
specifies 40\*d\*_41.4\*m\*_N, 74\*d\*_2.7\*m\*_W, and |
| 75 |
.B "\-c\ +404121\-0740240" |
| 76 |
specifies 40\*d\*_41\*m\*_21\*s\*_N, 74\*d\*_2\*m\*_40\*s\*_W. |
| 77 |
If |
| 78 |
.I coord |
| 79 |
is not one of the documented forms, the resulting behavior is unspecified. |
| 80 |
.TP |
| 81 |
.BI "\-n " limit |
| 82 |
When |
| 83 |
.B \-c |
| 84 |
is used, display the closest |
| 85 |
.I limit |
| 86 |
locations (default 10). |
| 87 |
.TP |
| 88 |
.B "\-\-help" |
| 89 |
Output help information and exit. |
| 90 |
.TP |
| 91 |
.B "\-\-version" |
| 92 |
Output version information and exit. |
| 93 |
.SH "ENVIRONMENT VARIABLES" |
| 94 |
.TP |
| 95 |
\f3AWK\fP |
| 96 |
Name of a POSIX-compliant |
| 97 |
.B awk |
| 98 |
program (default: |
| 99 |
.BR awk ). |
| 100 |
.TP |
| 101 |
\f3TZDIR\fP |
| 102 |
Name of the directory containing timezone data files (default: |
| 103 |
.BR /usr/share/zoneinfo ). |
| 104 |
.SH FILES |
| 105 |
.TP |
| 106 |
\f2TZDIR\fP\f3/iso3166.tab\fP |
| 107 |
Table of ISO 3166 2-letter country codes and country names. |
| 108 |
.TP |
| 109 |
\f2TZDIR\fP\f3/zone1970.tab\fP |
| 110 |
Table of country codes, latitude and longitude, timezones, and |
| 111 |
descriptive comments. |
| 112 |
.TP |
| 113 |
\f2TZDIR\fP\f3/\fP\f2TZ\fP |
| 114 |
Timezone data file for timezone \f2TZ\fP. |
| 115 |
.SH "EXIT STATUS" |
| 116 |
The exit status is zero if a timezone was successfully obtained from the user, |
| 117 |
nonzero otherwise. |
| 118 |
.SH "SEE ALSO" |
| 119 |
newctime(3), tzfile(5), zdump(8), zic(8) |
| 120 |
.SH NOTES |
| 121 |
Applications should not assume that |
| 122 |
.BR tzselect 's |
| 123 |
output matches the user's political preferences. |