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 location, and outputs the resulting
       timezone to standard output.  The output 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  closest 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  integers  followed  by an optional decimal point and fraction:
              positive 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  (default) 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 specifies 40 degrees 41 minutes 21 seconds N, 74 degrees 2
              minutes 40 seconds W.  If coord is not one of the documented  forms,  the  resulting  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)