.\" auto generated by yuck -*- nroff -*- .TH DATETEST "1" "May 2024" "dateutils 0.4.11" "User Commands" .SH "نام (NAME)" datetest \- مانند test(1) اما برای تاریخ‌ها .SH "خلاصه دستور (SYNOPSIS)" .B datetest [\fIOPTION\fR]... DATE/TIME1 \fIOP \fIDATE/TIME2 .SH "توضیحات (DESCRIPTION)" مانند دستور test(1) اما برای تاریخ‌ها عمل می‌کند. .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-i\fR, \fB--input-format\fR=\fISTRING\fR... قالب ورودی؛ می‌تواند چندین بار استفاده شود. هر تاریخ/زمان به ترتیبی که مشخص شده است به تجزیه‌کننده‌های قالب ورودی ارسال می‌شود؛ اگر تاریخ/زمان بتواند با یک رشته مشخص‌کننده قالب ورودی داده‌شده با موفقیت خوانده شود، همان مقدار استفاده خواهد شد. .TP .B \fB-b\fR, \fB--base\fR=\fIDT برای ورودی‌هایی با مشخصات ناکافی، از DT به عنوان مقدار پشتیبان جهت پر کردن فیلدهای مفقود استفاده می‌شود. همچنین برای مشخص‌کننده‌های قالب مبهم برای تعیین موقعیت محدوده آن‌ها در خط زمانی مطلق به کار می‌رود. باید یک تاریخ/زمان در قالب ISO8601 باشد. در صورت حذف، به صورت پیش‌فرض تاریخ/زمان فعلی در نظر گرفته می‌شود. .TP .B \fB--from-locale\fR=\fILOCALE تفسیر تاریخ‌ها در stdin یا خط فرمان به عنوان تاریخ‌های متعلق به لوکال LOCALE؛ این گزینه تنها بر نام ماه‌ها و روزهای هفته تأثیر می‌گذارد، چرا که قالب‌های ورودی باید به صورت صریح مشخص شوند. .TP .B \fB--from-zone\fR=\fIZONE تفسیر تاریخ‌ها در stdin یا خط فرمان بر اساس منطقه زمانی ZONE. .TP .B \fB-e\fR, \fB--backslash-escapes فعال‌سازی تفسیر گریزهای باک‌اسلش در رشته‌های مشخص‌کننده قالب ورودی و خروجی. .TP .B \fB--eq DATE/TIME1 با DATE/TIME2 یکسان است .TP .B \fB--ne DATE/TIME1 با DATE/TIME2 یکسان نیست .TP .B \fB--gt DATE/TIME1 جدیدتر از DATE/TIME2 است .TP .B \fB--lt DATE/TIME1 قدیمی‌تر از DATE/TIME2 است .TP .B \fB--ge DATE/TIME1 جدیدتر یا برابر با DATE/TIME2 است .TP .B \fB--le DATE/TIME1 قدیمی‌تر یا برابر با DATE/TIME2 است .TP .B \fB--nt DATE/TIME1 جدیدتر از DATE/TIME2 است .TP .B \fB--ot DATE/TIME1 قدیمی‌تر از DATE/TIME2 است .TP .B \fB--cmp مقایسه DATE/TIME1 با DATE/TIME2؛ بازگرداندن 0 در صورت برابری، 1 در صورتی که آرگومان سمت چپ جدیدتر باشد، و 2 در صورتی که آرگومان سمت راست جدیدتر باشد. .TP .B \fB--isvalid در صورتی که تاریخ‌های مشخص‌شده با قالب ورودی مطابقت داشته باشند، وضعیت موفقیت‌آمیز بازمی‌گرداند. .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 در سامانه‌های زمانی که مبدأ (Epoch) متفاوتی با مبدأ یونیکس دارند، این مورد تعداد ثانیه‌ها از آن مبدأ را انتخاب می‌کند. %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 یک نویسه خط جدید (newline) %t یک نویسه تب (tab) %% یک نویسه لفظی % .fi .PP اصلاح‌کننده‌ها: .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 $ datetest 2012-03-01 --gt 2012-03-02 || echo "false" false $ .fi .PP .nf $ datetest 2012-03-01 --ot 2012-03-02 && echo "true" true $ .fi .PP .nf $ datetest 2012-03-01 --cmp 2012-03-02; echo $? 2 $ .fi .PP .nf $ datetest 2012-03-02 --cmp 2012-03-02; echo $? 0 $ .fi .PP .nf $ datetest 2012-03-02 --cmp 2012-03-01; echo $? 1 $ .fi .PP .nf $ datetest 12:00:04 --gt 11:22:33 && echo "true" true $ .fi .PP .nf $ datetest 12:00:04 --lt 11:22:33 || echo "false" false $ .fi .PP .nf $ datetest 12:00:04 --cmp 11:22:33; echo "$@{?@}" 1 $ .fi .PP .nf $ datetest --cmp 11:22:33 12:00:04; echo "$@{?@}" 2 $ .fi .PP .nf $ datetest --ne 2012-03-02T00:00:00 2012-03-02 || echo 'false' false $ .fi .PP .nf $ datetest 2012-03-02T09:00:00 --ot 2012-03-02T10:00:00 && echo "true" true $ .fi .PP .nf $ datetest 2012-03-02T07:00:00 --cmp 2012-03-02T09:30:00; echo "$@{?@}" 2 $ .fi .PP .nf $ datetest --cmp 2012-03-02T12:00:00 2012-03-02T09:30:00; echo "$@{?@}" 1 $ .fi .PP .nf $ datetest 2012-03-02T07:00:00 --cmp 09:30:00; echo "$@{?@}" 3 $ .fi .PP .SH "نویسندگان (AUTHORS)" نوشته‌شده توسط Sebastian Freundt .PP .SH "گزارش باگ‌ها (BUGS)" گزارش باگ‌ها به: https://github.com/hroptatyr/dateutils/issues .PP .SH "همچنین ببینید (SEE ALSO)" مستندات کامل برای .B datetest به صورت یک کتابچه راهنمای Texinfo نگهداری می‌شود. در صورتی که برنامه‌های .B info و .B datetest به‌درستی روی سیستم شما نصب شده باشند، دستور .IP .B info (dateutils)datetest .PP باید به شما دسترسی به راهنمای کامل را بدهد. .\" yuck.m4man ends here