DATEZONE(1) User Commands DATEZONE(1)

datezone - تبدیل تاریخ/زمان میان مناطق زمانی

datezone [گزینه‌ها]... [نام_منطقه_زمانی]... [تاریخ/زمان]...

تبدیل تاریخ/زمان‌ها میان مناطق زمانی. اگر تاریخ/زمان مشخص نشود، مقدار پیش‌فرض آن `now` خواهد بود.

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

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

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

گزینه‌های شناخته‌شده (OPTION):

نمایش این راهنما و خروج
نمایش اطلاعات نسخه و خروج
عدم نمایش پیام‌های مربوط به خطاهای پارسر تاریخ/زمان یا نام منطقه زمانی و اصلاحات خودکار. حالت پیش‌فرض چاپ یک هشدار یا مقدار اصلاح‌شده و بازگرداندن کد خطای ۲ است.
برای ورودی‌هایی که به طور کامل مشخص نشده‌اند، از DT به عنوان مقدار جایگزین جهت پر کردن فیلدهای گمشده استفاده می‌کند. همچنین برای مشخص‌کننده‌های قالب مبهم جهت تعیین موقعیت بازه آن‌ها روی خط زمان مطلق به کار می‌رود. باید یک تاریخ/زمان در قالب ISO8601 باشد. در صورت عدم ذکر، پیش‌فرض تاریخ/زمان جاری است.
قالب ورودی؛ می‌تواند چندین بار استفاده شود. هر تاریخ/زمان به ترتیب به پارسرهای قالب ورودی ارسال می‌شود؛ اگر یک تاریخ/زمان با یک رشته مشخص‌کننده قالب ورودی داده‌شده با موفقیت خوانده شود، همان مقدار استفاده خواهد شد.
تفسیر تاریخ‌ها در ورودی استاندارد (stdin) یا خط فرمان به عنوان تاریخ‌های متعلق به لوکال LOCALE؛ این گزینه تنها بر نام ماه‌ها و روزهای هفته اثر می‌گذارد چرا که قالب‌های ورودی باید به صراحت مشخص شوند.
تفسیر تاریخ‌ها در ورودی استاندارد (stdin) یا خط فرمان به عنوان تاریخ‌های متعلق به منطقه زمانی ZONE.
نمایش تغییر بعدی به/از ساعت تابستانی (DST).
نمایش تغییر قبلی به/از ساعت تابستانی (DST).

مشخصات قالب در dateutils شبیه به تابع strftime() در استاندارد پازیکس (posix) است.

با این حال، به دلیل پشتیبانی از طیف گسترده‌تری از تقویم‌ها، dateutils باید قوانین متفاوتی را به کار گیرد.

مشخصات تاریخ:

%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)
%Od روز با اعداد رومی
%Om ماه با اعداد رومی
%Oy سال دو رقمی با اعداد رومی
%OY سال شامل قرن با اعداد رومی
%rs در سامانه‌های زمانی که مبدا آن‌ها با مبدا یونیکس متفاوت است،
    این گزینه تعداد ثانیه‌ها از آن مبدا را انتخاب می‌کند.
%rY در تقویم‌هایی با سال‌هایی که با سال‌های میلادی (گریگوری) همزمان نیستند،
    این گزینه سال تقویم مربوطه را انتخاب می‌کند.
%dth  روز ماه به عنوان عدد ترتیبی، 1st، 2nd، 3rd و غیره
%mth  ماه سال به عنوان عدد ترتیبی، 1st، 2nd، 3rd و غیره
%db روز کاری ماه (از آخرین روز کاری ماه قبل)
%dB تعداد روزهای کاری تا آخرین روز کاری این ماه

مشخصات زمان:

%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

مشخصات عمومی:

%n  کاراکتر خط جدید
%t  کاراکتر تب
%%  کاراکتر % واقعی

اصلاح‌کننده‌ها (Modifiers):

%O    اصلاح‌کننده برای تبدیل اعداد ده‌دهی به اعداد رومی
%r    اصلاح‌کننده برای تبدیل واحدها به واحدهای واقعی
%0    اصلاح‌کننده برای فعال‌سازی پیشوندهای صفر
%SPC  اصلاح‌کننده برای فعال‌سازی پیشوندهای فاصله
%-    اصلاح‌کننده برای غیرفعال‌سازی کامل پیشوندها
th    پسوند، خواندن و چاپ اعداد ترتیبی
b     پسوند، در نظر گرفتن روزها به عنوان روزهای کاری

طبق طراحی، تاریخ‌های قبل از 1601-01-01 پشتیبانی نمی‌شوند.

برای انطباق، در اینجا فهرستی از شناسه‌های تقویم و رشته قالب متناظر با آن‌ها آورده شده است:

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

این شناسه‌ها می‌توانند به عنوان رشته قالب خروجی استفاده شوند؛ علاوه بر این، @code{lilian}/@code{ldn} و @code{julian}/@code{jdn} نیز می‌توانند به عنوان رشته قالب ورودی به کار روند.

$ datezone 2012-03-04T12:04:11
2012-03-04T12:04:11+00:00
$
$ datezone Europe/Berlin 2012-03-04T12:04:11
2012-03-04T13:04:11+01:00	Europe/Berlin
$
$ datezone 2012-03-04T12:04:11 UTC
2012-03-04T12:04:11+00:00	UTC
$
$ 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
$

نوشته‌شده توسط Sebastian Freundt <freundt@fresse.org>

گزارش باگ‌ها به: https://github.com/hroptatyr/dateutils/issues

مستندات کامل برای datezone در قالب یک کتابچه راهنمای Texinfo نگهداری می‌شود. در صورتی که برنامه‌های info و datezone به‌درستی روی سیستم شما نصب شده باشند، دستور

info (dateutils)datezone

باید دسترسی شما را به راهنمای کامل فراهم کند.

May 2024 dateutils 0.4.11