'\" t
.\"     Title: rink-dates
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-08-30
.\"    Manual: Rink Manual
.\"    Source: Rink Manual
.\"  Language: Persian
.\"
.TH "RINK\-DATES" "5" "2026-08-30" "Rink Manual" "Rink Manual"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
rink-dates \- قالب فایل الگوهای تاریخ در ابزار Rink
.SH "خلاصه دستور (SYNOPSIS)"
.sp
ابزار Rink امکان مشخص کردن تاریخ و زمان را با استفاده از نحو \fB#date#\fP در پرس‌وجوها فراهم می‌کند. این فایل، الگوهایی را تعریف می‌کند که برای تطبیق با تاریخ مشخص‌شده به کار می‌روند.
.SH "توضیحات (DESCRIPTION)"
.sp
خطوط خالی نادیده گرفته می‌شوند. خطوطی که با # شروع شوند نادیده گرفته می‌شوند.
.sp
یک الگوی تاریخ دنباله‌ای از کلیدواژه‌ها است که هر کدام یک نشانه را برای تطبیق مشخص می‌کنند. بخشی از دنباله می‌تواند درون [] قرار گیرد تا اختیاری شود.
.sp
کلیدواژه‌های معتبر عبارتند از:
.sp
\fBfullyear\fP
.RS 4
سال کامل ۴ رقمی، مانند 2024. باید دقیقاً ۴ رقم باشد.
.RE
.sp
\fBshortyear\fP
.RS 4
سال کوتاه‌شده‌ی ۲ رقمی، مانند 24. باید دقیقاً ۲ رقم باشد.
.RE
.sp
\fBcentury\fP
.RS 4
سال بدون دو رقم آخر، مانند 20. این مقدار با شماره واقعی قرن (که در این مثال 21 خواهد بود) یکسان نیست. باید دقیقاً ۲ رقم باشد.
.RE
.sp
\fBmonthnum\fP
.RS 4
شماره ماه، مانند 03. باید دقیقاً ۲ رقم باشد.
.RE
.sp
\fBday\fP
.RS 4
روز ماه، مانند 3. می‌تواند هر تعداد رقم داشته باشد.
.RE
.sp
\fBfullday\fP
.RS 4
روز ماه، مانند 03. باید دقیقاً ۲ رقم باشد.
.RE
.sp
\fBmin\fP
.RS 4
دقیقه از ساعت، مانند 05. باید دقیقاً ۲ رقم باشد.
.RE
.sp
\fBordinal\fP
.RS 4
شماره ترتیبی روز در سال، مانند 083. باید دقیقاً ۳ رقم باشد.
.RE
.sp
\fBisoyear\fP
.RS 4
سال در قالب ISO، مانند \-0001. باید دقیقاً ۴ رقم باشد. سال ISO دوران‌های پس از میلاد (CE) و پیش از میلاد (BCE) را یکی می‌کند، به‌گونه‌ای که 1BC سال 0 و 2BCE سال \-1 است.
.RE
.sp
\fByear\fP
.RS 4
سال، مانند 2024. می‌تواند هر تعداد رقم داشته باشد.
.RE
.sp
\fBadbc\fP
.RS 4
به دنبال \f(CRad\fP، \f(CRce\fP، \f(CRbc\fP یا \f(CRbce\fP می‌گردد (حساس نبودن به بزرگی و کوچکی حروف). این مورد امکان تعیین تاریخ‌های پیش از سال ۱ پس از میلاد (1 CE) را فراهم می‌کند.
.RE
.sp
\fBhour12\fP
.RS 4
ساعت در قالب ۱۲ ساعته. باید دقیقاً ۲ رقم باشد.
.RE
.sp
\fBhour24\fP
.RS 4
ساعت در قالب ۲۴ ساعته. باید دقیقاً ۲ رقم باشد.
.RE
.sp
\fBmeridiem\fP
.RS 4
به دنبال \f(CRam\fP یا \f(CRpm\fP می‌گردد (حساس نبودن به بزرگی و کوچکی حروف). این مورد امکان تعیین زمان ۱۲ ساعته را فراهم می‌سازد.
.RE
.sp
\fBsec\fP
.RS 4
ثانیه‌ی دقیقه‌ی مربوطه. باید دقیقاً ۲ رقم باشد. می‌تواند به‌صورت اختیاری دارای ممیز اعشاری برای مشخص کردن زمان‌های کوچکتر از یک ثانیه باشد.
.RE
.sp
\fBoffset\fP
.RS 4
با اختلاف زمانی منطقه زمانی (timezone offset) مطابقت می‌یابد. این مقدار می‌تواند نام یک منطقه زمانی مانند \f(CRUS/Pacific\fP یا یک اختلاف زمانی ثابت باشد. اختلاف زمانی ثابت می‌تواند به فرم +07:00 یا +0700 باشد.
.RE
.sp
\fBmonthname\fP
.RS 4
با نام ماه‌ها در زبان انگلیسی بدون حساسیت به بزرگی و کوچکی حروف مطابقت می‌یابد. نام‌های ۳ حرفی (مانند jan، feb، mar) و نام‌های کامل را تشخیص می‌دهد.
.RE
.sp
\fBweekday\fP
.RS 4
با نام روزهای هفته در زبان انگلیسی بدون حساسیت به بزرگی و کوچکی حروف مطابقت می‌یابد. نام‌های ۳ حرفی (مانند mon، tue، wed) و نام‌های کامل را تشخیص می‌دهد.
.RE
.sp
\fBtoday\fP
.RS 4
از تاریخ جاری استفاده می‌کند، اما نه زمان. بیشترین کاربرد را هنگام ترکیب با \f(CRrelative\fP دارد.
.RE
.sp
\fBnow\fP
.RS 4
از زمان و تاریخ جاری استفاده می‌کند. بیشترین کاربرد را هنگام ترکیب با \f(CRrelative\fP دارد.
.RE
.sp
\fBrelative\fP
.RS 4
با یک واحد نسبی مطابقت می‌یابد، مانند \f(CR+1h\fP برای افزودن ۱ ساعت یا \f(CR\-7week\fP برای کسر کردن ۷ هفته. این ویژگی بر مبنای تقویم کار می‌کند، نه صرفاً بر حسب ثانیه.
.RE
.sp
\fB\f(CR\-\fP\fP
.RS 4
با کاراکتر تحت‌اللفظی \f(CR\-\fP مطابقت می‌یابد.
.RE
.sp
\fB\f(CR:\fP\fP
.RS 4
با کاراکتر تحت‌اللفظی \f(CR:\fP مطابقت می‌یابد.
.RE
.sp
` `
.RS 4
یک فاصله منفرد با هر مقدار نویسه فاصله خالی (whitespace) تطبیق می‌یابد.
.RE
.sp
\f(CR&\fP
.RS 4
امکان قرار دادن دو عبارت مستقیماً در کنار هم و بدون فاصله در میان آن‌ها را فراهم می‌کند.
.RE
.sp
\fB\f(CR\*(Aq\fP\fP <\fIanything\fP> \fB\f(CR\*(Aq\fP\fP
.RS 4
قرار دادن متن درون علامت نقل‌قول تکی (single quote) باعث مطابقت آن متن به‌صورت تحت‌اللفظی می‌شود.
.RE
.SH "فایل‌ها (FILES)"
.sp
ابزار Rink مسیرهای زیر را جستجو می‌کند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CR./datepatterns.txt\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CR\fI$XDG_CONFIG_DIR\fP/rink/datepatterns.txt\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CR/usr/share/rink/datepatterns.txt\fP
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
rink(1), rink(5),
rink(7), rink\-defs(5)