'\" t
.\"     Title: cal
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: دستورات کاربری
.\"    Source: util-linux 2.42.3
.\"  Language: Persian
.\"
.TH "CAL" "1" "2026-09-02" "util\-linux 2.42.3" "دستورات کاربری"
.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)"
cal \- نمایش تقویم
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBcal\fP [options] [[[\fIday\fP] \fImonth\fP] \fIyear\fP]
.sp
\fBcal\fP [options] [\fItimestamp\fP|\fImonthname\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBcal\fP یک تقویم ساده را نمایش می‌دهد. اگر هیچ آرگومانی مشخص نشود، ماه جاری نمایش داده می‌شود.
.sp
مقدار \fImonth\fP می‌تواند به صورت عدد (1\-12)، به صورت نام کامل ماه یا نام اختصاری ماه بر اساس محلی‌سازی‌های جاری مشخص شود.
.sp
دو سیستم تقویم مختلف استفاده می‌شود: گرگوری و ژولینی. این دو سیستم تقریباً یکسان هستند، با این تفاوت که تقویم گرگوری تنظیم کوچکی در بسامد سال‌های کبیسه ایجاد می‌کند؛ این کار هماهنگی بهتری با رویدادهای خورشیدی مانند اعتدالین فراهم می‌سازد. اصلاحات تقویم گرگوری در سال ۱۵۸۲ معرفی شد، اما پذیرش آن تا سال ۱۹۲۳ ادامه یافت. به صورت پیش‌فرض \fBcal\fP تاریخ ۳ سپتامبر ۱۷۵۲ را به عنوان تاریخ پذیرش استفاده می‌کند. از آن تاریخ به بعد تقویم گرگوری نمایش داده می‌شود؛ تاریخ‌های پیش از آن از سیستم تقویم ژولینی استفاده می‌کنند. در زمان پذیرش، ۱۱ روز حذف شدند تا تقویم با رویدادهای خورشیدی هماهنگ شود. بنابراین سپتامبر ۱۷۵۲ ترکیبی از تاریخ‌های ژولینی و گرگوری دارد که در آن پس از روز ۲ام، روز ۱۴ام قرار می‌گیرد (روزهای ۳ تا ۱۳ وجود ندارند).
.sp
به صورت اختیاری، می‌توان منحصراً از تقویم گرگوری گسترش‌یافته یا تقویم ژولینی استفاده کرد. بخش \fB\-\-reform\fP را در زیر ببینید.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-1\fP, \fB\-\-one\fP
.RS 4
نمایش خروجی تک‌ماهه. (این حالت پیش‌فرض است.)
.RE
.sp
\fB\-3\fP, \fB\-\-three\fP
.RS 4
نمایش سه ماه پیرامون تاریخ داده‌شده.
.RE
.sp
\fB\-n , \-\-months\fP \fInumber\fP
.RS 4
نمایش \fInumber\fP ماه، با شروع از ماهی که شامل تاریخ داده‌شده است.
.RE
.sp
\fB\-S, \-\-span\fP
.RS 4
نمایش ماه‌های پیرامون تاریخ داده‌شده.
.RE
.sp
\fB\-s\fP, \fB\-\-sunday\fP
.RS 4
نمایش یکشنبه به عنوان نخستین روز هفته.
.RE
.sp
\fB\-m\fP, \fB\-\-monday\fP
.RS 4
نمایش دوشنبه به عنوان نخستین روز هفته.
.RE
.sp
\fB\-v\fP, \fB\-\-vertical\fP
.RS 4
نمایش با استفاده از چیدمان عمودی (معروف به حالت \fBncal\fP(1)).
.RE
.sp
\fB\-\-iso\fP
.RS 4
نمایش منحصراً تقویم گرگوری گسترش‌یافته (proleptic Gregorian). این گزینه بر شماره‌های هفته و نخستین روز هفته تأثیری ندارد. بخش \fB\-\-reform\fP در زیر را ببینید.
.RE
.sp
\fB\-j\fP, \fB\-\-julian\fP
.RS 4
استفاده از شماره‌گذاری روز در سال برای تمام تقویم‌ها. به این روزها، روزهای ترتیبی (ordinal days) نیز گفته می‌شود. روزهای ترتیبی در بازه ۱ تا ۳۶۶ قرار دارند. این گزینه سیستم تقویم را از گرگوری به ژولینی تغییر نمی‌دهد؛ این کار توسط گزینه \fB\-\-reform\fP کنترل می‌شود.
.sp
گاهی اوقات به تقویم‌های گرگوری که از تاریخ‌های ترتیبی استفاده می‌کنند، تقویم‌های ژولینی گفته می‌شود. این موضوع می‌تواند به دلیل قراردادهای متعدد مرتبط با تاریخ که از واژه ژولینی در نام خود استفاده می‌کنند گیج‌کننده باشد: تاریخ ژولینی (ترتیبی)، تاریخ (تقویم) ژولینی، تاریخ ژولینی (نجومی)، تاریخ ژولینی (تعدیل‌شده) و موارد دیگر. این گزینه julian نامیده شده زیرا روزهای ترتیبی توسط استاندارد POSIX با نام julian شناخته می‌شوند. با این حال، توجه داشته باشید که \fBcal\fP از سیستم تقویم ژولینی نیز استفاده می‌کند. بخش \fBDESCRIPTION\fP در بالا را ببینید.
.RE
.sp
\fB\-\-reform\fP \fIval\fP
.RS 4
این گزینه تاریخ پذیرش اصلاحات تقویم گرگوری را تنظیم می‌کند. تاریخ‌های تقویم پیش از اصلاحات از سیستم تقویم ژولینی استفاده می‌کنند. تاریخ‌های تقویم پس از اصلاحات از سیستم تقویم گرگوری استفاده می‌کنند. آرگومان \fIval\fP می‌تواند موارد زیر باشد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fI1752\fP \- تاریخ ۳ سپتامبر ۱۷۵۲ را به عنوان تاریخ اصلاحات تنظیم می‌کند (پیش‌فرض). این زمانی است که اصلاحات تقویم گرگوری توسط امپراتوری بریتانیا پذیرفته شد.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIgregorian\fP \- تقویم‌های گرگوری را منحصراً نمایش می‌دهد. این جایگزین ویژه تاریخ اصلاحات را کمتر از کوچک‌ترین سال قابل استفاده در \fBcal\fP قرار می‌دهد؛ بدین معنی که تمام خروجی تقویم از سیستم تقویم گرگوری استفاده می‌کند. به این حالت تقویم گرگوری گسترش‌یافته (proleptic Gregorian) می‌گویند، زیرا تاریخ‌های پیش از ایجاد سیستم تقویم از مقادیر برون‌یابی‌شده استفاده می‌کنند.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIiso\fP \- نام مستعار برای \fIgregorian\fP. استاندارد ISO 8601 برای نمایش تاریخ‌ها و زمان‌ها در تبادل اطلاعات مستلزم استفاده از تقویم گرگوری گسترش‌یافته است.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIjulian\fP \- تقویم‌های ژولینی را منحصراً نمایش می‌دهد. این جایگزین ویژه تاریخ اصلاحات را بیشتر از بزرگ‌ترین سال قابل استفاده در \fBcal\fP قرار می‌دهد؛ بدین معنی که تمام خروجی تقویم از سیستم تقویم ژولینی استفاده می‌کند.
.RE
.sp
بخش \fBDESCRIPTION\fP در بالا را ببینید.
.RE
.sp
\fB\-y\fP, \fB\-\-year\fP
.RS 4
نمایش تقویم برای کل سال.
.RE
.sp
\fB\-Y, \-\-twelve\fP
.RS 4
نمایش تقویم برای دوازده ماه آینده.
.RE
.sp
\fB\-w\fP, \fB\-\-week\fP[\fB=\fP\fInumber\fP]
.RS 4
نمایش شماره هفته‌ها در تقویم بر اساس قالب US یا ISO\-8601.
اگر یک \fInumber\fP مشخص شود، هفته درخواستی در سال مورد نظر یا سال جاری چاپ شده و شماره آن برجسته می‌شود.
اگر \fImonth\fP نیز مشخص شده باشد، مقدار \fInumber\fP ممکن است نادیده گرفته شود.
.sp
اگر \fInumber\fP مشخص شده باشد اما روز جاری در خط فرمان مشخص نشده باشد، روز جاری برجسته نمی‌شود.
.sp
برای جزئیات بیشتر بخش \fBNOTES\fP را ببینید.
.RE
.sp
\fB\-\-color\fP[\fB=\fP\fIwhen\fP]
.RS 4
رنگی‌سازی خروجی. آرگومان اختیاری \fIwhen\fP می‌تواند \fBauto\fP، \fBnever\fP یا \fBalways\fP باشد. اگر آرگومان \fIwhen\fP حذف شود، مقدار پیش‌فرض آن \fBauto\fP است. رنگ‌ها را می‌توان غیرفعال کرد؛ برای مشاهده پیش‌فرض درونی جاری خروجی \fB\-\-help\fP را بررسی کنید. همچنین بخش \fBCOLORS\fP را ببینید.
.RE
.sp
\fB\-c, \-\-columns\fP=\fIcolumns\fP
.RS 4
تعداد ستون‌های مورد استفاده. مقدار \fBauto\fP به اندازه‌ای که در ترمینال جا شود ستون ایجاد می‌کند.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "پارامترها (PARAMETERS)"
.sp
\fBتک‌پارامتر فقط رقمی (مانند \*(Aqcal 2020\*(Aq)\fP
.RS 4
مشخص‌کننده \fIسال\fP برای نمایش؛ توجه داشته باشید که سال باید به طور کامل مشخص شود: دستور \fBcal 89\fP تقویمی برای سال ۱۹۸۹ نمایش نخواهد داد.
.RE
.sp
\fBتک‌پارامتر رشته‌ای (مانند \*(Aqcal tomorrow\*(Aq یا \*(Aqcal August\*(Aq)\fP
.RS 4
مشخص‌کننده برچسب زمان (\fItimestamp\fP) یا \fIنام ماه\fP (یا نام اختصاری آن) بر اساس محلی‌سازی‌های جاری.
.sp
هنگام تجزیه برچسب زمان، جایگزین‌های ویژه پذیرفته می‌شوند؛ "now" برای اشاره به زمان فعلی، و "today"، "yesterday" و "tomorrow" به ترتیب برای اشاره به روز جاری، روز قبل یا روز بعد استفاده می‌شوند.
.sp
مشخصات تاریخ نسبی نیز پذیرفته می‌شوند؛ در این حالت "+" به عنوان زمان فعلی به علاوه بازه زمانی مشخص‌شده ارزیابی می‌شود. به همین ترتیب، بازه زمانی دارای پیشوند "\-" به عنوان زمان فعلی منهای بازه زمانی مشخص‌شده ارزیابی می‌شود، مانند \*(Aq+2days\*(Aq. به جای قرار دادن پیشوند "+" یا "\-" روی بازه زمانی، می‌توان پسوند فاصله و کلمه "left" یا "ago" را نیز به کار برد (مانند \*(Aq1 week ago\*(Aq).
.RE
.sp
\fBدو پارامتر (مانند \*(Aqcal 11 2020\*(Aq)\fP
.RS 4
بیانگر \fIماه\fP (1 \- 12) و \fIسال\fP هستند.
.RE
.sp
\fBسه پارامتر (مانند \*(Aqcal 25 11 2020\*(Aq)\fP
.RS 4
بیانگر \fIروز\fP (1\-31)، \fIماه و سال\fP هستند، و اگر تقویم در ترمینال نمایش داده شود، روز مورد نظر برجسته خواهد شد. اگر هیچ پارامتری مشخص نشود، تقویم ماه جاری نمایش داده می‌شود.
.RE
.SH "نکات (NOTES)"
.sp
یک سال در ۱ ژانویه آغاز می‌شود. نخستین روز هفته توسط محلی‌سازی یا گزینه‌های \fB\-\-sunday\fP و \fB\-\-monday\fP تعیین می‌شود.
.sp
شماره‌گذاری هفته به انتخاب نخستین روز هفته بستگی دارد. اگر یکشنبه باشد، شماره‌گذاری مرسوم آمریکای شمالی استفاده می‌شود که در آن ۱ ژانویه در هفته شماره ۱ قرار دارد. اگر دوشنبه باشد (\fB\-m\fP)، شماره‌گذاری استاندارد ISO 8601 استفاده می‌شود که در آن نخستین پنجشنبه در هفته شماره ۱ قرار می‌گیرد.
.SH "رنگ‌ها (COLORS)"
.sp
رنگی‌سازی خروجی توسط قابلیت \fBterminal\-colors.d\fP(5) پیاده‌سازی شده است.
رنگ‌آمیزی ضمنی را می‌توان با یک فایل خالی
.RS 3
.ll -.6i
.sp
\fI/etc/terminal\-colors.d/cal.disable\fP
.br
.RE
.ll
.sp
برای دستور \fBcal\fP یا برای تمام ابزارها با فایل
.RS 3
.ll -.6i
.sp
\fI/etc/terminal\-colors.d/disable\fP
.br
.RE
.ll
.sp
غیرفعال کرد.
.sp
از نسخه ۲٫۴۱، متغیر محیطی $NO_COLOR نیز برای غیرفعال کردن رنگی‌سازی خروجی پشتیبانی می‌شود، مگر اینکه صریحاً توسط یک گزینه خط فرمان فعال شده باشد.
.sp
مسیرهای مختص کاربر \fI$XDG_CONFIG_HOME/terminal\-colors.d\fP یا \fI$HOME/.config/terminal\-colors.d\fP بر تنظیمات سراسری اولویت دارند.
.sp
توجه داشته باشید که رنگی‌سازی خروجی ممکن است به طور پیش‌فرض فعال باشد، و در این حالت نیازی نیست دایرکتوری‌های \fIterminal\-colors.d\fP از پیش وجود داشته باشند.
.sp
نام‌های رنگی منطقی پشتیبانی‌شده توسط \fBcal\fP عبارتند از:
.sp
\fBtoday\fP
.RS 4
روز جاری.
.RE
.sp
\fBweeknumber\fP
.RS 4
شماره هفته درخواست‌شده توسط گزینه خط فرمان \-\-week=<number>.
.RE
.sp
\fBweeks\fP
.RS 4
شماره هفته.
.RE
.sp
\fBheader\fP
.RS 4
سربرگ ماه.
.RE
.sp
\fBworkday\fP
.RS 4
روزهایی که در طول هفته کاری قرار دارند.
.RE
.sp
\fBweekend\fP
.RS 4
روزهایی که خارج از هفته کاری قرار دارند (پایان هفته).
.RE
.sp
برای نمونه:
.RS 3
.ll -.6i
.sp
echo \-e \*(Aqweekend 35\(rsntoday 1;41\(rsnheader yellow\*(Aq > $HOME/.config/terminal\-colors.d/cal.scheme
.br
.RE
.ll
.SH "تاریخچه (HISTORY)"
.sp
دستور \fBcal\fP در AT&T UNIX نسخه ۶ ظاهر شد.
.SH "ایرادها (BUGS)"
.sp
خروجی پیش‌فرض \fBcal\fP از تاریخ ۳ سپتامبر ۱۷۵۲ به عنوان تاریخ اصلاحات تقویم گرگوری استفاده می‌کند. تاریخ‌های اصلاحات تاریخی برای سایر مناطق، از جمله معرفی آن در اکتبر ۱۵۸۲، پیاده‌سازی نشده‌اند.
.sp
تقویم‌های جایگزین، مانند ام‌القری، هجری خورشیدی، گعز (Ge\(cqez)، یا قمری\-شمسی هندی، پشتیبانی نمی‌شوند.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBterminal\-colors.d\fP(5)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "سامانه پیگیری مشکلات" "."
استفاده کنید.
.SH "در دسترس بودن (AVAILABILITY)"
.sp
دستور \fBcal\fP بخشی از بسته util\-linux است که می‌توان آن را از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "آرشیو هسته لینوکس" "."
دریافت کرد.