'\" t
.\"     Title: cal
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-05-18
.\"    Manual: أوامر المستخدم
.\"    Source: util-linux 2.42.1
.\"  Language: English
.\"
.TH "CAL" "1" "2026-05-18" "util\-linux 2.42.1" "أوامر المستخدم"
.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 "الاسم"
cal \- يعرض تقويماً
.SH "موجز"
.sp
\fBcal\fP [خيارات] [[[\fIاليوم\fP] \fIالشهر\fP] \fIالسنة\fP]
.sp
\fBcal\fP [خيارات] [\fIطابع_زمني\fP|\fIاسم_الشهر\fP]
.SH "الوصف"
.sp
يعرض \fBcal\fP تقويماً بسيطاً. إذا لم تُحدد أي معطيات، فسيُعرض الشهر الحالي.
.sp
يمكن تحديد \fIالشهر\fP كرقم (1\-12)، أو كاسم شهر، أو كاسم شهر مختصر وفقاً للمحليات الحالية.
.sp
يُستخدم نظاما تقويم مختلفان، الغريغوري واليولياني. هذان النظامان متطابقان تقريباً مع إجراء التقويم الغريغوري تعديلاً طفيفاً على تكرار السنوات الكبيسة؛ مما يسهل تحسين المزامنة مع الأحداث الشمسية مثل الاعتدالات. أُدخل إصلاح التقويم الغريغوري في عام 1582، لكن اعتماده استمر حتى عام 1923. مبدئياً، يستخدم \fBcal\fP تاريخ الاعتماد 3 سبتمبر 1752. ومن ذلك التاريخ فصاعداً يُعرض التقويم الغريغوري؛ بينما تستخدم التواريخ السابقة نظام التقويم اليولياني. حُذف 11 يوماً وقت الاعتماد لجعل التقويم متزامناً مع الأحداث الشمسية. لذا فإن سبتمبر 1752 يحتوي على خليط من التواريخ اليوليانية والغريغورية حيث يتبع يوم 2 يوم 14 (الأيام من 3 إلى 13 غائبة).
.sp
اختيارياً، يمكن استخدام إما التقويم الغريغوري الاستباقي أو التقويم اليولياني حصرياً. راجع \fB\-\-reform\fP أدناه.
.SH "الخيارات"
.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 \fIعدد\fP
.RS 4
يعرض \fIعددًا\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
اعرض التقويم الغريغوري الاستباقي حصرياً. لا يؤثر هذا الخيار على أرقام الأسابيع واليوم الأول من الأسبوع. انظر \fB\-\-reform\fP أدناه.
.RE
.sp
\fB\-j\fP، \fB\-\-julian\fP
.RS 4
استخدم ترقيم يوم\-من\-السنة لجميع التقاويم. تُسمى هذه أيضاً الأيام الترتيبية. تتراوح الأيام الترتيبية من 1 إلى 366. لا يغير هذا الخيار نظام التقويم من الغريغوري إلى اليولياني، حيث يُتحكم في ذلك عبر خيار \fB\-\-reform\fP.
.sp
يُشار أحياناً إلى التقاويم الغريغورية التي تستخدم التواريخ الترتيبية على أنها تقاويم يوليانية. قد يكون هذا مربكاً بسبب كثرة الاصطلاحات المتعلقة بالتاريخ والتي تستخدم اسم يولياني في مسمياتها: التاريخ اليولياني (الترتيبي)، تاريخ التقويم اليولياني، التاريخ اليولياني (الفلكي)، التاريخ اليولياني (المعدل)، وغيرها. سُمي هذا الخيار "julian" لأن الأيام الترتيبية تُعرف بأنها يوليانية في معيار POSIX. ومع ذلك، كن على علم بأن \fBcal\fP يستخدم أيضاً نظام التقويم اليولياني. انظر \fBالوصف\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 \- يضبط 3 سبتمبر 1752 كتاريخ للإصلاح (مبدئي). وهو الوقت الذي وُحد فيه إصلاح التقويم الغريغوري من قبل الإمبراطورية البريطانية.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIgregorian\fP \- اعرض التقاويم الغريغورية حصرياً. يضبط هذا العنصر النائب تاريخ الإصلاح قبل أصغر سنة يمكن لـ \fBcal\fP استخدامها؛ مما يعني أن جميع مخرجات التقويم تستخدم نظام التقويم الغريغوري. يُسمى هذا بالتقويم الغريغوري الاستباقي، لأن التواريخ السابقة لإنشاء نظام التقويم تستخدم قيماً مُستقرأة.
.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
انظر \fBالوصف\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\fIرقم\fP]
.RS 4
يعرض أرقام الأسابيع في التقويم وفقاً لتنسيق الولايات المتحدة أو ISO\-8601. إذا حُدد رقم \fInumber\fP، سيُطبع الأسبوع المطلوب في السنة المرغوبة أو الحالية ويُبرز رقمه. قد يُتجاهل الرقم \fInumber\fP إذا حُدد الشهر \fImonth\fP أيضاً.
.sp
إذا حُدد الرقم \fInumber\fP ولكن اليوم الحالي لم يُحدد في سطر الأوامر، فلن يُبرز اليوم الحالي.
.sp
انظر قسم \fBملاحظات\fP لمزيد من التفاصيل.
.RE
.sp
\fB\-\-color\fP[\fB=\fP\fIمتى\fP]
.RS 4
لون المخرجات. المعامل الاختياري \fIمتى\fP يمكن أن يكون \fBauto\fP أو \fBnever\fP أو \fBalways\fP. إذا حُذف معامل \fIمتى\fP، فإنه يعود إلى \fBauto\fP آليًا. يمكن تعطيل الألوان؛ للاطلاع على الوضع المبدئي المدمج الحالي راجع مخرجات \fB\-\-help\fP. انظر أيضًا قسم \fBالألوان\fP.
.RE
.sp
\fB\-c, \-\-columns\fP=\fIأعمدة\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 "المعاملات"
.sp
\fBمعلمة وحيدة بالأرقام فقط (مثال: \*(Aqcal 2020\*(Aq)\fP
.RS 4
تحدد الـ \fIسنة\fP المراد عرضها؛ لاحظ أنه يجب تحديد السنة بالكامل: \fBcal 89\fP لن يعرض تقويماً لعام 1989.
.RE
.sp
\fBمعلمة سلسلة نصية وحيدة (مثال: \*(Aqcal tomorrow\*(Aq أو \*(Aqcal August\*(Aq)\fP
.RS 4
تحدد الـ \fIطابع\-زمني\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) والـ \fImonth and year\fP، وسيُبرز اليوم إذا عُرض التقويم على طرفية. إذا لم تُحدد أي معلمات، يُعرض تقويم الشهر الحالي.
.RE
.SH "ملاحظات"
.sp
تبدأ السنة في 1 يناير. يُحدد اليوم الأول من الأسبوع بواسطة المحلية أو خياري \fB\-\-sunday\fP و \fB\-\-monday\fP.
.sp
يعتمد ترقيم الأسابيع على اختيار اليوم الأول من الأسبوع. إذا كان الأحد، فيُستخدم الترقيم المعتاد في أمريكا الشمالية، حيث يقع 1 يناير في الأسبوع رقم 1. إذا كان الاثنين (\fB\-m\fP) فيُستخدم ترقيم الأسابيع القياسي ISO 8601، حيث يقع أول يوم خميس في الأسبوع رقم 1.
.SH "الألوان"
.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
منذ الإصدار 2.41، دُعم متغير البيئة $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
\fBاليوم\fP
.RS 4
اليوم الحالي.
.RE
.sp
\fBرقم الأسبوع\fP
.RS 4
رقم الأسبوع المطلوب بواسطة خيار سطر الأوامر \-\-week=<الرقم>.
.RE
.sp
\fBأسابيع\fP
.RS 4
رقم الأسبوع.
.RE
.sp
\fBheader\fP
.RS 4
ترويسة الشهر.
.RE
.sp
\fBworkday\fP
.RS 4
الأيام التي تقع ضمن أسبوع العمل.
.RE
.sp
\fBنهاية الأسبوع\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 "تاريخ"
.sp
ظهر الأمر \fBcal\fP في الإصدار السادس من AT&T UNIX.
.SH "العلل"
.sp
يستخدم مخرَج \fBcal\fP المبدئي تاريخ 3 سبتمبر 1752 كتاريخ لإصلاح التقويم الميلادي. أما تواريخ الإصلاح التاريخية للمحليات الأخرى، بما في ذلك تقديمه في أكتوبر 1582، فهي غير مُنفذة.
.sp
التقاويم البديلة، مثل أم القرى، أو الهجري الشمسي، أو الجعزي، أو الهندوسي القمري الشمسي، غير متاحة.
.SH "انظر أيضاً"
.sp
‎\fBterminal\-colors.d\fP(5)
.SH "التبليغ عن الأخطاء"
.sp
لتقارير العِلل، استخدم \c
.URL "https://github.com/util\-linux/util\-linux/issues" "مُتتبع المشكلات" "."
.SH "التوفر"
.sp
الأمر \fBcal\fP جزء من حزمة util\-linux التي يمكن تنزيلها من \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "أرشيف نواة لينكس" "."