1996-09-08 15:50:26 -04:00
|
|
|
.TH TZSELECT 8
|
|
|
|
|
.SH NAME
|
|
|
|
|
tzselect \- select a time zone
|
|
|
|
|
.SH SYNOPSIS
|
2014-06-28 16:35:14 -07:00
|
|
|
.ie \n(.g .ds - \f(CW-\fP
|
|
|
|
|
.el ds - \-
|
1996-09-08 15:50:26 -04:00
|
|
|
.B tzselect
|
2013-08-16 12:19:42 -07:00
|
|
|
[
|
2014-06-28 16:35:14 -07:00
|
|
|
.B \*-c
|
2013-08-20 00:57:59 -07:00
|
|
|
.I coord
|
|
|
|
|
] [
|
2014-06-28 16:35:14 -07:00
|
|
|
.B \*-n
|
2013-08-20 00:57:59 -07:00
|
|
|
.I limit
|
|
|
|
|
] [
|
2014-06-28 16:35:14 -07:00
|
|
|
.B \*-\*-help
|
2013-08-16 12:19:42 -07:00
|
|
|
] [
|
2014-06-28 16:35:14 -07:00
|
|
|
.B \*-\*-version
|
2013-08-16 12:19:42 -07:00
|
|
|
]
|
1996-09-08 15:50:26 -04:00
|
|
|
.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.
|
2013-08-16 12:19:42 -07:00
|
|
|
.SH OPTIONS
|
|
|
|
|
.TP
|
2014-06-28 16:35:14 -07:00
|
|
|
.BI "\*-c " coord
|
2013-08-20 00:57:59 -07:00
|
|
|
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
|
2013-08-20 20:22:07 -07:00
|
|
|
.I coord.
|
2013-08-20 00:57:59 -07:00
|
|
|
Use ISO 6709 notation for
|
2013-08-20 20:22:07 -07:00
|
|
|
.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,
|
2014-06-28 16:35:14 -07:00
|
|
|
.B "\*-c\ +40.689\*-074.045"
|
2013-08-20 20:22:07 -07:00
|
|
|
specifies 40.689\(de\|N, 74.045\(de\|W,
|
2014-06-28 16:35:14 -07:00
|
|
|
.B "\*-c\ +4041.4\*-07402.7"
|
2013-08-20 20:22:07 -07:00
|
|
|
specifies 40\(de\|41.4\(fm\|N, 74\(de\|2.7\(fm\|W, and
|
2014-06-28 16:35:14 -07:00
|
|
|
.B "\*-c\ +404121\*-0740240"
|
2013-08-20 20:22:07 -07:00
|
|
|
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.
|
2013-08-20 00:57:59 -07:00
|
|
|
.TP
|
2014-06-28 16:35:14 -07:00
|
|
|
.BI "\*-n " limit
|
2013-08-20 00:57:59 -07:00
|
|
|
When
|
2014-06-28 16:35:14 -07:00
|
|
|
.B \*-c
|
2013-08-20 00:57:59 -07:00
|
|
|
is used, display the closest
|
|
|
|
|
.I limit
|
|
|
|
|
locations (default 10).
|
2013-08-16 12:19:42 -07:00
|
|
|
.TP
|
2014-06-28 16:35:14 -07:00
|
|
|
.B "\*-\*-help"
|
2013-08-16 12:19:42 -07:00
|
|
|
Output help information and exit.
|
|
|
|
|
.TP
|
2014-06-28 16:35:14 -07:00
|
|
|
.B "\*-\*-version"
|
2013-08-16 12:19:42 -07:00
|
|
|
Output version information and exit.
|
1996-09-08 15:50:26 -04:00
|
|
|
.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
|
2014-07-31 15:20:45 -07:00
|
|
|
\f2TZDIR\fP\f3/zone1970.tab\fP
|
New file time.tab, superseding zone.tab
It allows multiple country codes per zone. Switch code and data to
use the new format, along with the recently-added Crozet Islands entry.
The old zone.tab file is still installed but is deprecated.
The new file uses UTF-8; add commentary saying that iso3166.tab is
planned to change to UTF-8.
* Theory, tzselect.8 (FILES): zone.tab -> time.tab.
* africa (Indian/Alfred_Faure): Remove link.
* antarctica: Mention Possession Island in comments.
* checktab.awk: Add support for checking time.tab.
* iso3166.tab: Mention planned switch to UTF-8.
Update ISO 3166-1 Newsletter from VI-15 to VI-16.
* time.tab: New file.
* tzselect.ksh (zonetabtype): New variable.
Add undocumented -t option, meant for developer testing.
(TZ_ZONE_TABLE): Use zonetabtype.
(output_distances, countries, regions, TZ): Support time.tab format.
(quoted_continents, distance_table, countries, regions)
(TZ, TZ_for_date): Quote shell strings more carefully.
* zone.tab: Refer to time.tab for detailed comments about format.
(Indian/Alfred_Faure): Remove.
* Makefile (TIMETABLES): New macro.
(TABDATA, install, check_tables): Use it.
(check_character_set, check_tables): Check time.tab too.
(check_time_t_alternatives): Use time.tab, not zone.tab.
* NEWS: Document the above.
2014-07-18 13:16:10 -07:00
|
|
|
Table of country codes, latitude and longitude, zone names, and
|
1996-09-08 15:50:26 -04:00
|
|
|
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)
|
2014-07-22 19:50:32 -07:00
|
|
|
.SH NOTES
|
|
|
|
|
Applications should not assume that
|
|
|
|
|
.BR tzselect 's
|
|
|
|
|
output matches the user's political preferences.
|
2009-05-17 14:37:50 -04:00
|
|
|
.\" This file is in the public domain, so clarified as of
|
|
|
|
|
.\" 2009-05-17 by Arthur David Olson.
|