Debian Codegraph @

upstream/debian-unstable/man8/tzselect.8

raw
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.