"Fossies" - the Fresh Open Source Software Archive

Member "tzselect.8" (27 Jun 2018, 2893 Bytes) of package /linux/misc/tzcode2018i.tar.gz:


Caution: As a special service "Fossies" has tried to format the requested manual source page into HTML format but links to other man pages may be missing or even errorneous. Alternatively you can here view or download the uninterpreted manual source code. A member file download can also be achieved by clicking within a package contents listing on the according byte size field. See also the last Fossies "Diffs" side-by-side code changes report for "tzselect.8": 2018e_vs_2018f.

TZSELECT

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
ENVIRONMENT VARIABLES
FILES
EXIT STATUS
SEE ALSO
NOTES

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.