نام (NAME)

datetest - مانند test(1) اما برای تاریخ‌ها

خلاصه دستور (SYNOPSIS)

datetest [OPTION]... DATE/TIME1 OP DATE/TIME2

توضیحات (DESCRIPTION)

مانند دستور test(1) اما برای تاریخ‌ها عمل می‌کند.

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

-h, --help: نمایش راهنما و خروج
-V, --version: نمایش نسخه و خروج
-q, --quiet: نادیده گرفتن پیام‌های مربوط به خطاهای تجزیه‌گر تاریخ/زمان و بازه زمانی.
-i, --input-format=STRING...: قالب ورودی؛ می‌تواند چندین بار استفاده شود. هر تاریخ/زمان به ترتیبی که مشخص شده است به تجزیه‌کننده‌های قالب ورودی ارسال می‌شود؛ اگر تاریخ/زمان بتواند با یک رشته مشخص‌کننده قالب ورودی داده‌شده با موفقیت خوانده شود، همان مقدار استفاده خواهد شد.
-b, --base=DT: برای ورودی‌هایی با مشخصات ناکافی، از DT به عنوان مقدار پشتیبان جهت پر کردن فیلدهای مفقود استفاده می‌شود. همچنین برای مشخص‌کننده‌های قالب مبهم برای تعیین موقعیت محدوده آن‌ها در خط زمانی مطلق به کار می‌رود. باید یک تاریخ/زمان در قالب ISO8601 باشد. در صورت حذف، به صورت پیش‌فرض تاریخ/زمان فعلی در نظر گرفته می‌شود.
--from-locale=LOCALE: تفسیر تاریخ‌ها در stdin یا خط فرمان به عنوان تاریخ‌های متعلق به لوکال LOCALE؛ این گزینه تنها بر نام ماه‌ها و روزهای هفته تأثیر می‌گذارد، چرا که قالب‌های ورودی باید به صورت صریح مشخص شوند.
--from-zone=ZONE: تفسیر تاریخ‌ها در stdin یا خط فرمان بر اساس منطقه زمانی ZONE.
-e, --backslash-escapes: فعال‌سازی تفسیر گریزهای باک‌اسلش در رشته‌های مشخص‌کننده قالب ورودی و خروجی.
--eq: DATE/TIME1 با DATE/TIME2 یکسان است
--ne: DATE/TIME1 با DATE/TIME2 یکسان نیست
--gt: DATE/TIME1 جدیدتر از DATE/TIME2 است
--lt: DATE/TIME1 قدیمی‌تر از DATE/TIME2 است
--ge: DATE/TIME1 جدیدتر یا برابر با DATE/TIME2 است
--le: DATE/TIME1 قدیمی‌تر یا برابر با DATE/TIME2 است
--nt: DATE/TIME1 جدیدتر از DATE/TIME2 است
--ot: DATE/TIME1 قدیمی‌تر از DATE/TIME2 است
--cmp: مقایسه DATE/TIME1 با DATE/TIME2؛ بازگرداندن 0 در صورت برابری، 1 در صورتی که آرگومان سمت چپ جدیدتر باشد، و 2 در صورتی که آرگومان سمت راست جدیدتر باشد.
--isvalid: در صورتی که تاریخ‌های مشخص‌شده با قالب ورودی مطابقت داشته باشند، وضعیت موفقیت‌آمیز بازمی‌گرداند.

مشخصات قالب (FORMAT SPECS)

مشخصات قالب در 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 در سامانه‌های زمانی که مبدأ (Epoch) متفاوتی با مبدأ یونیکس دارند، این
    مورد تعداد ثانیه‌ها از آن مبدأ را انتخاب می‌کند.
%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  یک نویسه خط جدید (newline)
%t  یک نویسه تب (tab)
%%  یک نویسه لفظی %

اصلاح‌کننده‌ها:

%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} نیز می‌توانند به عنوان رشته قالب ورودی به کار روند.

مثال‌ها (EXAMPLES)

$ datetest 2012-03-01 --gt 2012-03-02 || echo "false"
false
$

$ datetest 2012-03-01 --ot 2012-03-02 && echo "true"
true
$

$ datetest 2012-03-01 --cmp 2012-03-02; echo $?
2
$

$ datetest 2012-03-02 --cmp 2012-03-02; echo $?
0
$

$ datetest 2012-03-02 --cmp 2012-03-01; echo $?
1
$

$ datetest 12:00:04 --gt 11:22:33 && echo "true"
true
$

$ datetest 12:00:04 --lt 11:22:33 || echo "false"
false
$

$ datetest 12:00:04 --cmp 11:22:33; echo "$@{?@}"
1
$

$ datetest --cmp 11:22:33 12:00:04; echo "$@{?@}"
2
$

$ datetest --ne 2012-03-02T00:00:00 2012-03-02 || echo 'false'
false
$

$ datetest 2012-03-02T09:00:00 --ot 2012-03-02T10:00:00 && echo "true"
true
$

$ datetest 2012-03-02T07:00:00 --cmp 2012-03-02T09:30:00; echo "$@{?@}"
2
$

$ datetest --cmp 2012-03-02T12:00:00 2012-03-02T09:30:00; echo "$@{?@}"
1
$

$ datetest 2012-03-02T07:00:00 --cmp 09:30:00; echo "$@{?@}"
3
$

نویسندگان (AUTHORS)

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

گزارش باگ‌ها (BUGS)

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

همچنین ببینید (SEE ALSO)

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

: info (dateutils)datetest

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