contrib/tzcode/tzselect.8.txt

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