.\" This file is in the public domain, so clarified as of
.\" 2009-05-17 by Arthur David Olson.
.TH "TZSELECT" "8" "مه ۲۰۲۵" "tzdata" "دستورات مدیریت سیستم"
.SH "نام (NAME)"
tzselect \- انتخاب تعاملی منطقه زمانی (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)"
دستور \fBtzselect\fR با پرسیدن یک سری سوالات تعاملی از کاربر، منطقه زمانی جاری سیستم را تعیین و متغیر محیطی TZ مناسب را تولید میکند.
.PP
خروجی این دستور برای استفاده به عنوان مقدار متغیر محیطی TZ مناسب است.
.PP
تمامی تعاملات با کاربر از طریق ورودی استاندارد (stdin) و خروجی استاندارد خطا (stderr) انجام می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "\*-c " coord
به‌جای پرسیدن قاره، کشور و سپس شهر، گزینه‌هایی از مناطق زمانی را پیشنهاد می‌دهد که بزرگ‌ترین شهرهای آن‌ها به مختصات جغرافیایی
.I coord
نزدیک‌تر هستند.
برای
.I coord
از استاندارد ISO 6709 استفاده کنید، به این صورت که عرض جغرافیایی بلافاصله با طول جغرافیایی همراه باشد.
عرض و طول جغرافیایی باید اعدادی علامت‌دار باشند که در صورت تمایل نقطه اعشار و بخش کسری به دنبال آن‌ها بیاید: اعداد مثبت نشان‌دهنده شمال و شرق، و اعداد منفی نشان‌دهنده جنوب و غرب هستند.
عرض‌های جغرافیایی با دو رقم صحیح و طول‌های جغرافیایی با سه رقم صحیح به عنوان درجه در نظر گرفته می‌شوند؛ عرض‌های جغرافیایی با چهار یا شش رقم و طول‌های جغرافیایی با پنج یا هفت رقم صحیح به صورت
.I "DDMM, DDDMM, DDMMSS,"
یا
.I DDDMMSS
در نظر گرفته می‌شوند که بیانگر
.I DD
یا
.I DDD
درجه،
.I MM
دقیقه،
و صفر یا
.I SS
ثانیه هستند؛ هرگونه کسر انتهایی نشان‌دهنده کسر دقیقه یا (در صورت حضور
.IR SS )
ثانیه است. ممیز اعشار مطابق با لوکال جاری سیستم تعیین می‌شود.
برای مثال، در لوکال پیش‌فرض C:
.PP
.nf
\fB\-c +40.689\-074.045\fR مشخص‌کننده 40.689\*d\*_N, 74.045\*d\*_W
\fB\-c +4041.4\-07402.7\fR مشخص‌کننده 40\*d\*_41.4\*m\*_N, 74\*d\*_2.7\*m\*_W
\fB\-c +404121\-0740240\fR مشخص‌کننده 40\*d\*_41\*m\*_21\*s\*_N, 74\*d\*_2\*m\*_40\*s\*_W
.fi
.PP
اگر
.I coord
یکی از قالب‌های مستندشده نباشد، رفتار حاصل نامشخص خواهد بود.
.TP
.BI "\*-n " limit
هنگامی که گزینه
.B \*-c
استفاده شود، نزدیک‌ترین مکان‌ها را تا سقف
.I limit
مورد نمایش می‌دهد (پیش‌فرض ۱۰).
.TP
.B "\*-\*-help"
نمایش اطلاعات راهنما و خروج.
.TP
.B "\*-\*-version"
نمایش اطلاعات نگارش و خروج.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.TP
\f3AWK\fP
نام یک برنامه
.B awk
سازگار با استاندارد POSIX (پیش‌فرض:
.BR awk ).
.TP
\f3TZDIR\fP
نام دایرکتوری حاوی فایل‌های داده منطقه زمانی (پیش‌فرض:
.BR /usr/share/zoneinfo ).
.SH "فایل‌ها (FILES)"
.TP
\f2TZDIR\fP\f3/iso3166.tab\fP
جدول کدهای دورقمی کشورها و نام کشورها بر اساس استاندارد ISO 3166.
.TP
\f2TZDIR\fP\f3/zone1970.tab\fP
جدول کدهای کشور، عرض و طول جغرافیایی، مناطق زمانی و توضیحات مربوطه.
.TP
\f2TZDIR\fP\f3/\fP\f2TZ\fP
فایل داده منطقه زمانی برای منطقه زمانی \f2TZ\fP.
.SH "وضعیت خروج (EXIT STATUS)"
در صورت دریافت موفقیت‌آمیز منطقه زمانی از کاربر، وضعیت خروج صفر و در غیر این صورت غیرصفر است.
.SH "همچنین ببینید (SEE ALSO)"
.BR newctime (3),
.BR tzfile (5),
.BR zdump (8),
.BR zic (8)
.SH "نکات (NOTES)"
برنامه‌ها نباید فرض کنند که خروجی
.B tzselect
با ترجیحات یا مواضع سیاسی کاربر مطابقت دارد.