tzselect(8) System Manager's Manual tzselect(8)
NAME
tzselect - select a timezone
SYNOPSIS
tzselect [ -c coord ] [ -n limit ] [ --help ] [ --version ]
DESCRIPTION
The tzselect program asks the user for information about the current lo-
cation, and outputs the resulting timezone to standard output. The out-
put is suitable as a value for the TZ environment variable.
All interaction with the user is done via standard input and standard
error.
OPTIONS
-c coord
Instead of asking for continent and then country and then city,
ask for selection from time zones whose largest cities are clos-
est to the location with geographical coordinates coord. Use ISO
6709 notation for coord, that is, a latitude immediately followed
by a longitude. The latitude and longitude should be signed in-
tegers followed by an optional decimal point and fraction: posi-
tive numbers represent north and east, negative south and west.
Latitudes with two and longitudes with three integer digits are
treated as degrees; latitudes with four or six and longitudes
with five or seven integer digits are treated as DDMM, DDDMM,
DDMMSS, or DDDMMSS representing DD or DDD degrees, MM minutes,
and zero or SS seconds, with any trailing fractions represent
fractional minutes or (if SS is present) seconds. The decimal
point is that of the current locale. For example, in the (de-
fault) C locale, -c +40.689-074.045 specifies 40.689 degrees N,
74.045 degrees W, -c +4041.4-07402.7 specifies 40 degrees 41.4
minutes N, 74 degrees 2.7 minutes W, and -c +404121-0740240 spec-
ifies 40 degrees 41 minutes 21 seconds N, 74 degrees 2 minutes 40
seconds W. If coord is not one of the documented forms, the re-
sulting behavior is unspecified.
-n limit
When -c is used, display the closest limit locations (default
10).
--help Output help information and exit.
--version
Output version information and exit.
ENVIRONMENT VARIABLES
AWK Name of a POSIX-compliant awk program (default: awk).
TZDIR Name of the directory containing timezone data files (default:
/usr/share/zoneinfo).
FILES
TZDIR/iso3166.tab
Table of ISO 3166 2-letter country codes and country names.
TZDIR/zone1970.tab
Table of country codes, latitude and longitude, timezones, and
descriptive comments.
TZDIR/TZ
Timezone data file for timezone TZ.
EXIT STATUS
The exit status is zero if a timezone was successfully obtained from the
user, nonzero otherwise.
SEE ALSO
newctime(3), tzfile(5), zdump(8), zic(8)
NOTES
Applications should not assume that tzselect's output matches the user's
political preferences.
Time Zone Database tzselect(8)
Generated by dwww version 1.16 on Mon Dec 8 07:33:08 CET 2025.