tzselect

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
       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°N, 74.045°W,
              -c +4041.4-07402.7 specifies 40°41.4′N, 74°2.7′W, and
              -c +404121-0740240 specifies 40°41′21″N, 74°2′40″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.



                                                                     TZSELECT(8)