MFC after: 3 weeks Sponsored by: Klara, Inc. Reviewed by: philip Differential Revision: https://reviews.freebsd.org/D39712
126 lines
3.0 KiB
Groff
126 lines
3.0 KiB
Groff
.\" This file is in the public domain, so clarified as of
|
|
.\" 2009-05-17 by Arthur David Olson.
|
|
.TH tzselect 8 "" "Time Zone Database"
|
|
.SH NAME
|
|
tzselect \- select a timezone
|
|
.SH SYNOPSIS
|
|
.ie \n(.g .ds - \f(CR-\fP
|
|
.el .ds - \-
|
|
.ds d " degrees
|
|
.ds m " minutes
|
|
.ds s " seconds
|
|
.ds _ " \&
|
|
.if t \{\
|
|
. if \n(.g .if c \(de .if c \(fm .if c \(sd \{\
|
|
. ds d \(de
|
|
. ds m \(fm
|
|
. ds s \(sd
|
|
. 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 timezone 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\*d\*_N, 74.045\*d\*_W,
|
|
.B "\*-c\ +4041.4\*-07402.7"
|
|
specifies 40\*d\*_41.4\*m\*_N, 74\*d\*_2.7\*m\*_W, and
|
|
.B "\*-c\ +404121\*-0740240"
|
|
specifies 40\*d\*_41\*m\*_21\*s\*_N, 74\*d\*_2\*m\*_40\*s\*_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
|
|
.B awk
|
|
program (default:
|
|
.BR awk ).
|
|
.TP
|
|
\f3TZDIR\fP
|
|
Name of the directory containing timezone data files (default:
|
|
.BR /usr/share/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, timezones, and
|
|
descriptive comments.
|
|
.TP
|
|
\f2TZDIR\fP\f3/\fP\f2TZ\fP
|
|
Timezone data file for timezone \f2TZ\fP.
|
|
.SH "EXIT STATUS"
|
|
The exit status is zero if a timezone 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.
|