• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1TZSELECT(8)                 System Manager's Manual                TZSELECT(8)
2
3NAME
4       tzselect - select a timezone
5
6SYNOPSIS
7       tzselect [ -c coord ] [ -n limit ] [ --help ] [ --version ]
8
9DESCRIPTION
10       The tzselect program asks the user for information about the current
11       location, and outputs the resulting timezone to standard output.  The
12       output is suitable as a value for the TZ environment variable.
13
14       All interaction with the user is done via standard input and standard
15       error.
16
17OPTIONS
18       -c coord
19              Instead of asking for continent and then country and then city,
20              ask for selection from time zones whose largest cities are
21              closest to the location with geographical coordinates coord.
22              Use ISO 6709 notation for coord, that is, a latitude immediately
23              followed by a longitude.  The latitude and longitude should be
24              signed integers followed by an optional decimal point and
25              fraction: positive numbers represent north and east, negative
26              south and west.  Latitudes with two and longitudes with three
27              integer digits are treated as degrees; latitudes with four or
28              six and longitudes with five or seven integer digits are treated
29              as DDMM, DDDMM, DDMMSS, or DDDMMSS representing DD or DDD
30              degrees, MM minutes, and zero or SS seconds, with any trailing
31              fractions represent fractional minutes or (if SS is present)
32              seconds.  The decimal point is that of the current locale.  For
33              example, in the (default) C locale, -c +40.689-074.045 specifies
34              40.689<degree>N, 74.045<degree>W, -c +4041.4-07402.7 specifies
35              40<degree>41.4'N, 74<degree>2.7'W, and -c +404121-0740240
36              specifies 40<degree>41'21''N, 74<degree>2'40''W.  If coord is
37              not one of the documented forms, the resulting behavior is
38              unspecified.
39
40       -n limit
41              When -c is used, display the closest limit locations (default
42              10).
43
44       --help Output help information and exit.
45
46       --version
47              Output version information and exit.
48
49ENVIRONMENT VARIABLES
50       AWK    Name of a Posix-compliant awk program (default: awk).
51
52       TZDIR  Name of the directory containing timezone data files (default:
53              /usr/share/zoneinfo).
54
55FILES
56       TZDIR/iso3166.tab
57              Table of ISO 3166 2-letter country codes and country names.
58
59       TZDIR/zone1970.tab
60              Table of country codes, latitude and longitude, timezones, and
61              descriptive comments.
62
63       TZDIR/TZ
64              Timezone data file for timezone TZ.
65
66EXIT STATUS
67       The exit status is zero if a timezone was successfully obtained from
68       the user, nonzero otherwise.
69
70SEE ALSO
71       newctime(3), tzfile(5), zdump(8), zic(8)
72
73NOTES
74       Applications should not assume that tzselect's output matches the
75       user's political preferences.
76
77                                                                   TZSELECT(8)
78