1tzselect(8)                 System Manager's Manual                tzselect(8)
2
3
4

NAME

6       tzselect - select a timezone
7

SYNOPSIS

9       tzselect [ -c coord ] [ -n limit ] [ --help ] [ --version ]
10

DESCRIPTION

12       The  tzselect  program  asks the user for information about the current
13       location, and outputs the resulting timezone to standard  output.   The
14       output is suitable as a value for the TZ environment variable.
15
16       All  interaction  with the user is done via standard input and standard
17       error.
18

OPTIONS

20       -c coord
21              Instead of asking for continent and then country and then  city,
22              ask for selection from time zones whose largest cities are clos‐
23              est to the location with geographical  coordinates  coord.   Use
24              ISO  6709  notation  for  coord, that is, a latitude immediately
25              followed by a longitude.  The latitude and longitude  should  be
26              signed  integers followed by an optional decimal point and frac‐
27              tion: positive numbers represent north and east, negative  south
28              and  west.  Latitudes with two and longitudes with three integer
29              digits are treated as degrees; latitudes with four  or  six  and
30              longitudes  with  five  or  seven  integer digits are treated as
31              DDMM, DDDMM, DDMMSS, or DDDMMSS representing DD or DDD  degrees,
32              MM  minutes, and zero or SS seconds, with any trailing fractions
33              represent fractional minutes or (if SS is present) seconds.  The
34              decimal  point  is  that of the current locale.  For example, in
35              the (default) C locale, -c +40.689-074.045 specifies 40.689  de‐
36              grees  N,  74.045 degrees W, -c +4041.4-07402.7 specifies 40 de‐
37              grees  41.4  minutes  N,  74  degrees   2.7   minutes   W,   and
38              -c +404121-0740240 specifies 40 degrees 41 minutes 21 seconds N,
39              74 degrees 2 minutes 40 seconds W.  If coord is not one  of  the
40              documented forms, the resulting behavior is unspecified.
41
42       -n limit
43              When  -c  is  used, display the closest limit locations (default
44              10).
45
46       --help Output help information and exit.
47
48       --version
49              Output version information and exit.
50

ENVIRONMENT VARIABLES

52       AWK    Name of a Posix-compliant awk program (default: awk).
53
54       TZDIR  Name of the directory containing timezone data  files  (default:
55              /usr/share/zoneinfo).
56

FILES

58       TZDIR/iso3166.tab
59              Table of ISO 3166 2-letter country codes and country names.
60
61       TZDIR/zone1970.tab
62              Table  of  country codes, latitude and longitude, timezones, and
63              descriptive comments.
64
65       TZDIR/TZ
66              Timezone data file for timezone TZ.
67

EXIT STATUS

69       The exit status is zero if a timezone was  successfully  obtained  from
70       the user, nonzero otherwise.
71

SEE ALSO

73       newctime(3), tzfile(5), zdump(8), zic(8)
74

NOTES

76       Applications  should  not  assume  that  tzselect's  output matches the
77       user's political preferences.
78
79
80
81Time Zone Database                                                 tzselect(8)
Impressum