.\" auto generated by yuck -*- nroff -*-
.TH DATEZONE "1" "May 2024" "dateutils 0.4.11" "User Commands"
.SH "نام (NAME)"
datezone \- تبدیل تاریخ/زمان میان مناطق زمانی
.SH "خلاصه دستور (SYNOPSIS)"
.B datezone
[\fIگزینه‌ها\fR]...
\fR[\fIنام_منطقه_زمانی\fR]\fR... \fI\fR[\fIتاریخ/زمان\fR]\fR...
.SH "توضیحات (DESCRIPTION)"
تبدیل تاریخ/زمان‌ها میان مناطق زمانی.
اگر تاریخ/زمان مشخص نشود، مقدار پیش‌فرض آن `now` خواهد بود.

مقدار تاریخ/زمان می‌تواند یکی از مقادیر ویژه زیر نیز باشد:
  - `now`           به عنوان برچسب زمانی جاری (UTC) تفسیر می‌شود
  - `time`          بخش زمان برچسب زمانی جاری (UTC)
  - `today`         تاریخ جاری (بر اساس UTC)
  - `tomo[rrow]`    تاریخ فردا (بر اساس UTC)
  - `y[ester]day`   تاریخ دیروز (بر اساس UTC)

هنگامی که تاریخ/زمان یک تاریخ باشد (یعنی مولفه زمان حذف شده باشد)
نتیجه، اختلاف منطقه زمانی را در پایان آن روز نشان می‌دهد.

هنگامی که تاریخ/زمان یک زمان باشد (یعنی مولفه تاریخ حذف شده باشد)
تبدیل روی تاریخی که توسط --base|-b مشخص شده انجام می‌شود،
که به طور پیش‌فرض تاریخ جاری است.

.PP

گزینه‌های شناخته‌شده (\fIOPTION\fR):
.TP
.B   \fB-h\fR, \fB--help
نمایش این راهنما و خروج
.TP
.B   \fB-V\fR, \fB--version
نمایش اطلاعات نسخه و خروج
.TP
.B   \fB-q\fR, \fB--quiet
عدم نمایش پیام‌های مربوط به خطاهای پارسر تاریخ/زمان یا نام منطقه زمانی و اصلاحات خودکار.
حالت پیش‌فرض چاپ یک هشدار یا مقدار اصلاح‌شده و بازگرداندن کد خطای ۲ است.
.TP
.B   \fB-b\fR, \fB--base\fR=\fIDT
برای ورودی‌هایی که به طور کامل مشخص نشده‌اند، از DT به عنوان مقدار جایگزین جهت پر کردن فیلدهای گمشده استفاده می‌کند. همچنین برای مشخص‌کننده‌های قالب مبهم جهت تعیین موقعیت بازه آن‌ها روی خط زمان مطلق به کار می‌رود.
باید یک تاریخ/زمان در قالب ISO8601 باشد.
در صورت عدم ذکر، پیش‌فرض تاریخ/زمان جاری است.
.TP
.B   \fB-i\fR, \fB--input-format\fR=\fISTRING\fR...
قالب ورودی؛ می‌تواند چندین بار استفاده شود.
هر تاریخ/زمان به ترتیب به پارسرهای قالب ورودی ارسال می‌شود؛ اگر یک تاریخ/زمان با یک رشته مشخص‌کننده قالب ورودی داده‌شده با موفقیت خوانده شود، همان مقدار استفاده خواهد شد.
.TP
.B       \fB--from-locale\fR=\fILOCALE
تفسیر تاریخ‌ها در ورودی استاندارد (stdin) یا خط فرمان به عنوان تاریخ‌های متعلق به لوکال LOCALE؛ این گزینه تنها بر نام ماه‌ها و روزهای هفته اثر می‌گذارد چرا که قالب‌های ورودی باید به صراحت مشخص شوند.
.TP
.B       \fB--from-zone\fR=\fIZONE
تفسیر تاریخ‌ها در ورودی استاندارد (stdin) یا خط فرمان به عنوان تاریخ‌های متعلق به منطقه زمانی ZONE.
.TP
.B       \fB--next
نمایش تغییر بعدی به/از ساعت تابستانی (DST).
.TP
.B       \fB--prev
نمایش تغییر قبلی به/از ساعت تابستانی (DST).
.SH "مشخصات قالب (FORMAT SPECS)"
.PP
مشخصات قالب در dateutils شبیه به تابع strftime() در استاندارد پازیکس (posix) است.
.PP
با این حال، به دلیل پشتیبانی از طیف گسترده‌تری از تقویم‌ها، dateutils باید قوانین متفاوتی را به کار گیرد.
.PP
مشخصات تاریخ:
.nf
  %a  نام اختصاری روز هفته
  %A  نام کامل روز هفته
  %_a نام روز هفته خلاصه‌شده به یک حرف تک (MTWRFAS)
  %b  نام اختصاری ماه
  %B  نام کامل ماه
  %_b نام ماه خلاصه‌شده به یک حرف تک (FGHJKMNQUVXZ)
  %c  شمارش روز هفته در ماه (بازه 00 تا 05)
  %C  شمارش روز هفته در سال (بازه 00 تا 53)
  %d  روز ماه، ۲ رقم (بازه 00 تا 31)
  %D  روز سال، ۳ رقم (بازه 000 تا 366)
  %F  معادل با %Y-%m-%d (قالب استاندارد ymd)
  %g  سال تقویم هفته ISO بدون قرن (بازه 00 تا 99)
  %G  سال تقویم هفته ISO شامل قرن
  %j  معادل با %D
  %m  ماه در تقویم جاری (بازه 00 تا 12)
  %Q  فصل سال (بازه Q1 تا Q4)
  %q  شماره فصل (بازه 01 تا 04)
  %s  تعداد ثانیه‌ها از مبدا زمان یونیکس (Epoch)
  %u  روز هفته به صورت عدد (بازه 01 تا 07، یکشنبه 07 است)
  %U  شمارش هفته، روز اول هفته یکشنبه است (بازه 00 تا 53)
  %V  شمارش هفته ISO، روز اول هفته دوشنبه است (بازه 01 تا 53)
  %w  روز هفته به صورت عدد (بازه 00 تا 06، یکشنبه 00 است)
  %W  شمارش هفته، روز اول هفته دوشنبه است (بازه 00 تا 53)
  %y  سال بدون قرن (بازه 00 تا 99)
  %Y  سال شامل قرن
  %_y سال خلاصه‌شده به یک رقم
  %Z  اختلاف منطقه زمانی بر حسب ساعت و دقیقه (HH:MM) همراه با
      علامت پیشوند (+ برای اختلاف‌های شرق UTC و - برای اختلاف‌های
      غرب UTC)
.fi
.PP
.nf
  %Od روز با اعداد رومی
  %Om ماه با اعداد رومی
  %Oy سال دو رقمی با اعداد رومی
  %OY سال شامل قرن با اعداد رومی
.fi
.PP
.nf
  %rs در سامانه‌های زمانی که مبدا آن‌ها با مبدا یونیکس متفاوت است،
      این گزینه تعداد ثانیه‌ها از آن مبدا را انتخاب می‌کند.
  %rY در تقویم‌هایی با سال‌هایی که با سال‌های میلادی (گریگوری) همزمان نیستند،
      این گزینه سال تقویم مربوطه را انتخاب می‌کند.
.fi
.PP
.nf
  %dth  روز ماه به عنوان عدد ترتیبی، 1st، 2nd، 3rd و غیره
  %mth  ماه سال به عنوان عدد ترتیبی، 1st، 2nd، 3rd و غیره
.fi
.PP
.nf
  %db روز کاری ماه (از آخرین روز کاری ماه قبل)
  %dB تعداد روزهای کاری تا آخرین روز کاری این ماه
.fi
.PP
مشخصات زمان:
.nf
  %H  ساعت در قالب ۲۴ ساعته، ۲ رقم (بازه 00 تا 23)
  %I  ساعت در قالب ۱۲ ساعته، ۲ رقم (بازه 01 تا 12)
  %M  دقیقه (بازه 00 تا 59)
  %N  نانوثانیه (بازه 000000000 تا 999999999)
  %p  رشته AM یا PM، ظهر PM و نیمه‌شب AM است
  %P  مانند %p اما با حروف کوچک
  %S  ثانیه (بازه 00 تا 60، مقدار 60 برای ثانیه‌های کبیسه است)
  %T  معادل با %H:%M:%S
.fi
.PP
مشخصات عمومی:
.nf
  %n  کاراکتر خط جدید
  %t  کاراکتر تب
  %%  کاراکتر % واقعی
.fi
.PP
اصلاح‌کننده‌ها (Modifiers):
.nf
  %O    اصلاح‌کننده برای تبدیل اعداد ده‌دهی به اعداد رومی
  %r    اصلاح‌کننده برای تبدیل واحدها به واحدهای واقعی
  %0    اصلاح‌کننده برای فعال‌سازی پیشوندهای صفر
  %SPC  اصلاح‌کننده برای فعال‌سازی پیشوندهای فاصله
  %-    اصلاح‌کننده برای غیرفعال‌سازی کامل پیشوندها
  th    پسوند، خواندن و چاپ اعداد ترتیبی
  b     پسوند، در نظر گرفتن روزها به عنوان روزهای کاری
.fi
.PP
طبق طراحی، تاریخ‌های قبل از 1601-01-01 پشتیبانی نمی‌شوند.
.PP
برای انطباق، در اینجا فهرستی از شناسه‌های تقویم و رشته قالب متناظر با آن‌ها آورده شده است:
.nf
  ymd     %Y-%m-%d
  ymcw    %Y-%m-%c-%w
  ywd     %rY-W%V-%u
  bizda   %Y-%m-%db
  lilian     n/a
  ldn        n/a
  julian     n/a
  jdn        n/a
  matlab     n/a
  mdn        n/a
.fi
.PP
این شناسه‌ها می‌توانند به عنوان رشته قالب خروجی استفاده شوند؛ علاوه بر این،
@code{lilian}/@code{ldn} و @code{julian}/@code{jdn} نیز می‌توانند
به عنوان رشته قالب ورودی به کار روند.

.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
  $ datezone 2012-03-04T12:04:11
  2012-03-04T12:04:11+00:00
  $
.fi
.PP
.nf
  $ datezone Europe/Berlin 2012-03-04T12:04:11
  2012-03-04T13:04:11+01:00	Europe/Berlin
  $
.fi
.PP
.nf
  $ datezone 2012-03-04T12:04:11 UTC
  2012-03-04T12:04:11+00:00	UTC
  $
.fi
.PP
.nf
  $ datezone Europe/Berlin Australia/Sydney 2012-01-01T14:04:00 2012-05-14T12:04:00
  2012-01-01T15:04:00+01:00	Europe/Berlin
  2012-01-02T01:04:00+11:00	Australia/Sydney
  2012-05-14T14:04:00+02:00	Europe/Berlin
  2012-05-14T22:04:00+10:00	Australia/Sydney
  $
.fi
.PP

.SH "نویسنده (AUTHOR)"
نوشته‌شده توسط Sebastian Freundt <freundt@fresse.org>
.PP
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها به: https://github.com/hroptatyr/dateutils/issues
.PP

.SH "همچنین ببینید (SEE ALSO)"
مستندات کامل برای
.B datezone
در قالب یک کتابچه راهنمای Texinfo نگهداری می‌شود. در صورتی که برنامه‌های
.B info
و
.B datezone
به‌درستی روی سیستم شما نصب شده باشند، دستور
.IP
.B info (dateutils)datezone
.PP
باید دسترسی شما را به راهنمای کامل فراهم کند.
.\" yuck.m4man ends here