.\" auto generated by yuck -*- nroff -*-
.TH STRPTIME "1" "May 2024" "dateutils 0.4.11" "User Commands"
.SH "نام (NAME)"
strptime \- تجزیه ورودی از stdin مطابق با یکی از قالب‌های (FORMATs) داده‌شده.
.SH "خلاصه دستور (SYNOPSIS)"
.B strptime
[\fIOPTION\fR]... 
\fR[\fIINPUT\fR]\fR...
.SH "توضیحات (DESCRIPTION)"
ورودی از stdin را مطابق با یکی از قالب‌های FORMAT داده‌شده تجزیه می‌کند.
مشخصه‌کننده‌های رشته قالب مشابه با strptime(3) هستند.

.PP

گزینه‌های (\fIOPTION\fR) شناخته‌شده:
.TP
.B   \fB-h\fR, \fB--help
نمایش راهنما و خروج
.TP
.B   \fB-V\fR, \fB--version
نمایش نسخه و خروج
.TP
.B   \fB-t\fR, \fB--time
همچنین نمایش زمان در خروجی؛ پیش‌فرض نمایش تاریخ است
.TP
.B   \fB-q\fR, \fB--quiet
نادیده گرفتن پیام خطاهای تجزیه‌گر تاریخ/زمان و مدت زمان.
.TP
.B   \fB-f\fR, \fB--format\fR=\fISTRING
قالب خروجی. این می‌تواند یک رشته مشخصه‌کننده (مشابه FMT در strftime()) یا نام یک تقویم باشد.
.TP
.B   \fB-i\fR, \fB--input-format\fR=\fISTRING\fR...
قالب ورودی، می‌تواند چندین بار استفاده شود.
هر تاریخ/زمان به ترتیبی که داده شده به تجزیه‌کننده‌های
قالب ورودی فرستاده می‌شود؛ اگر تاریخ/زمان بتواند با یک
رشته مشخصه‌کننده قالب ورودی داده‌شده با موفقیت خوانده
شود، آن مقدار استفاده خواهد شد.
.TP
.B   \fB-e\fR, \fB--backslash-escapes
فعال‌سازی تفسیر گریزهای ممیز وارونه (backslash escapes) در
رشته‌های مشخصه‌کننده قالب خروجی و ورودی.
.TP
.B   \fB-l\fR, \fB--locale
رفتار داخلی strptime(3) و strftime(3) را وابسته به locale
می‌کند؛ پیش‌فرض وانمود کردن به برقراری LC_ALL=C است.
.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) آن‌ها متفاوت از unix 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  نویسه خط جدید
  %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
  $ strptime -i '%a, %b-%d/%Y' 'Mon, May-01/2000'
  2000-05-01
  $
.fi
.PP
.nf
  $ strptime -i '%a, %b-%d/%Y' <<EOF
  Mon, May-01/2000
  Mon, Mar-2/2000
  EOF
  2000-05-01
  2000-03-02
  $
.fi
.PP

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



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