117 lines
2.9 KiB
Groff
117 lines
2.9 KiB
Groff
.\" $NetBSD: tzselect.8,v 1.6 2014/08/15 11:04:07 christos Exp $
|
|
.\"
|
|
.TH TZSELECT 8
|
|
.SH NAME
|
|
tzselect \- select a time zone
|
|
.SH SYNOPSIS
|
|
.ie \n(.g .ds - \f(CW-\fP
|
|
.el ds - \-
|
|
.B tzselect
|
|
[
|
|
.B \*-c
|
|
.I coord
|
|
] [
|
|
.B \*-n
|
|
.I limit
|
|
] [
|
|
.B \*-\*-help
|
|
] [
|
|
.B \*-\*-version
|
|
]
|
|
.SH DESCRIPTION
|
|
The
|
|
.B tzselect
|
|
program asks the user for information about the current location,
|
|
and outputs the resulting time zone description to standard output.
|
|
The output is suitable as a value for the TZ environment variable.
|
|
.PP
|
|
All interaction with the user is done via standard input and standard error.
|
|
.SH OPTIONS
|
|
.TP
|
|
.BI "\*-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
|
|
.I coord.
|
|
Use ISO 6709 notation for
|
|
.I 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
|
|
.I "DDMM, DDDMM, DDMMSS,"
|
|
or
|
|
.I DDDMMSS
|
|
representing
|
|
.I DD
|
|
or
|
|
.I DDD
|
|
degrees,
|
|
.I MM
|
|
minutes,
|
|
and zero or
|
|
.I SS
|
|
seconds, with any trailing fractions represent fractional minutes or
|
|
(if
|
|
.I SS
|
|
is present) seconds. The decimal point is that of the current locale.
|
|
For example, in the (default) C locale,
|
|
.B "\*-c\ +40.689\*-074.045"
|
|
specifies 40.689\(de\|N, 74.045\(de\|W,
|
|
.B "\*-c\ +4041.4\*-07402.7"
|
|
specifies 40\(de\|41.4\(fm\|N, 74\(de\|2.7\(fm\|W, and
|
|
.B "\*-c\ +404121\*-0740240"
|
|
specifies 40\(de\|41\(fm\|21\(sd\|N, 74\(de\|2\(fm\|40\(sd\|W.
|
|
If
|
|
.I coord
|
|
is not one of the documented forms, the resulting behavior is unspecified.
|
|
.TP
|
|
.BI "\*-n " limit
|
|
When
|
|
.B \*-c
|
|
is used, display the closest
|
|
.I limit
|
|
locations (default 10).
|
|
.TP
|
|
.B "\*-\*-help"
|
|
Output help information and exit.
|
|
.TP
|
|
.B "\*-\*-version"
|
|
Output version information and exit.
|
|
.SH "ENVIRONMENT VARIABLES"
|
|
.TP
|
|
\f3AWK\fP
|
|
Name of a Posix-compliant
|
|
.I awk
|
|
program (default:
|
|
.BR awk ).
|
|
.TP
|
|
\f3TZDIR\fP
|
|
Name of the directory containing time zone data files (default:
|
|
.BR /usr/local/etc/zoneinfo ).
|
|
.SH FILES
|
|
.TP
|
|
\f2TZDIR\fP\f3/iso3166.tab\fP
|
|
Table of ISO 3166 2-letter country codes and country names.
|
|
.TP
|
|
\f2TZDIR\fP\f3/zone1970.tab\fP
|
|
Table of country codes, latitude and longitude, zone names, and
|
|
descriptive comments.
|
|
.TP
|
|
\f2TZDIR\fP\f3/\fP\f2TZ\fP
|
|
Time zone data file for time zone \f2TZ\fP.
|
|
.SH "EXIT STATUS"
|
|
The exit status is zero if a time zone was successfully obtained from the user,
|
|
nonzero otherwise.
|
|
.SH "SEE ALSO"
|
|
newctime(3), tzfile(5), zdump(8), zic(8)
|
|
.SH NOTES
|
|
Applications should not assume that
|
|
.BR tzselect 's
|
|
output matches the user's political preferences.
|
|
.\" @(#)tzselect.8 8.2
|
|
.\" This file is in the public domain, so clarified as of
|
|
.\" 2009-05-17 by Arthur David Olson.
|