الفرق بين المراجعتين لصفحة: «Python/calendar»

المراجعة الحالية بتاريخ 08:26، 4 أغسطس 2018

تتيح هذه الوحدة الحصول على تقاويم مشابهة لمخرجات البرنامج cal في أنظمة يونكس، إلى جانب أنّها تقدّم عددًا من التوابع المفيدة والخاصة بالتقاويم. يبدأ الأسبوع في هذه التقاويم بصورة افتراضية بيوم الإثنين، وينتهي بيوم الأحد (هذا هو السائد في أوروبا).

يمكن استخدام الدالة setfirstweekday()‎ لجعل الأسبوع يبدأ بيوم الأحد (6) أو أي يوم آخر. تكون المعاملات التي تحدّد التواريخ أعدادًا صحيحة. تقدّم بايثون وحدتين إضافيتين للتعامل مع الوقت والتاريخ هما datetime و time.

تستخدم الدوال والأصناف المعرّفة في هذه الوحدة تقويمًا مثاليًا، وهو التقويم الكريكوري الحالي والممتدّ في كلا الاتجاهين (الماضي والمستقبل) وإلى ما لا نهاية. يتطابق هذا التقويم مع "التقويم التنبؤي" والذي يقدّمه Dershowitz و Reingold في كتابهما "Calendrical Calculations" والذي يمثّل التقويم الأساسي والمعتمد في جميع أنظمة الحواسيب. يفسّر الصفر والسنوات ذات الأرقام السالبة كما هو موصوف في معيار ISO 8601، لتكون السنة 0 هي السنة 1 قبل الميلاد، و ‎-1 هي السنة 2 قبل الميلاد، وهكذا دواليك.

دوال الوحدة `calendar`

تقدّم وحدة calendar عددًا من الدوال الخاصّة بالتقاويم النصية البسيطة.

الدالة `setfirstweekday()‎`

تعيّن الدالة اليوم الذي يبدأ به الأسبوع.

الدالة `firstweekday()‎`

تعيد الدالة الإعدادات الحالية الخاصة باليوم الذي يبدأ به الأسبوع.

الدالة `isleap()‎`

تخبر الدالة ما إذا كانت السنة المعطاة كبيسة أم لا.

الدالة `leapdays()‎`

تعيد الدالة عدد السنوات الكبيسة ضمن نطاق السنوات المحدد.

الدالة `weekday()‎`

تعيد الدالة يوم الأسبوع في الشهر المعطى في السنة المعطاة.

الدالة `weekheader()‎`

تعيد الدالة ترويسة تتضمن أسماء أيام الأسبوع بصيغة مختصرة.

الدالة `monthrange()‎`

تعيد الدالة أول يوم في الشهر وعدد أيام الشهر المعطى في السنة المعطاة.

الدالة `monthcalendar()‎`

تعيد الدالة مصفوفة matrix تمثّل تقويم الشهر.

الدالة `prmonth()‎`

تطبع الدالة تقويم الشهر الذي تعيده الدالة month()‎.

الدالة `month()‎`

تعيد الدالة تقويم الشهر على هيئة سلسلة نصية متعددة الأسطر.

الدالة `prcal()‎`

تطبع الدالة تقويم السنة برمّتها والذي تعيده الدالة calendar()‎.

الدالة `calendar()‎`

تعيد الدالة تقويمًا ذا ثلاثة أعمدة يتضمّن سنة كاملة وعلى هيئة سلسلة نصية متعددة الأسطر.

الدالة `timegm()‎`

تعيد الدالة قيمة الختم الزمني المقابل في نظام يونكس.

خصائص الوحدة `calendar`

تقدّم وحدة calendar الخصائص التالية:

الخاصية `calendar.day_name`

مصفوفة تعرض أيام الأسبوع في الإعدادات المحلية الحالية.

الخاصية `calendar.day_abbr`

مصفوفة تعرض الأسماء المختصرة لأيام الأسبوع في الإعدادات المحلية الحالية.

الخاصية `calendar.month_name`

مصفوفة تعرض أشهر السنة في الإعدادات المحلية الحالية. تتبع هذا الخاصية ما هو متعارف عليه في أن يكون شهر كانون الثاني (يناير) هو الشهر رقم 1، لذا يكون طول المصفوفة 13، وتكون month_name[0]‎ سلسلة فارغة.

الخاصية `calendar.month_abbr`

مصفوفة تعرض الأسماء المختصرة لأشهر السنة في الإعدادات المحلية الحالية. تتبع هذا الخاصية ما هو متعارف عليه في أن يكون شهر كانون الثاني (يناير) هو الشهر رقم 1، لذا يكون طول المصفوفة 13، وتكون month_name[0]‎ سلسلة فارغة.

أصناف الوحدة `calendar`

تقدم وحدة calendar الأصناف الخمسة التالية للتعامل مع التقاويم بطرق مختلفة:

الصنف `Calendar`

يقدّم كائن Calendar عددًا من التوابع التي يمكن استخدامها لتحضير بيانات التقويم لغرض التنسيق.

الصنف `TextCalendar`

يستخدم هذا الصنف لإنشاء تقويم بهيئة نصية صرفة plain text.

الصنف `HTMLCalendar`

يمكن استخدام هذا الصنف لإنشاء تقاويم بصيغة HTML.

الصنف `LocaleTextCalendar`

هذا الصنف متفرّع من الصنف TextCalendar، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة نصية صرفة.

الصنف `LocaleHTMLCalendar`

هذا الصنف متفرّع من الصنف HTMLCalendar، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة HTML.

انظر أيضًا

وحدة datetime في بايثون.

مصادر

صفحة General calendar-related functions في توثيق بايثون الرسمي.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE:التابع <code>datetime.time()‎</code> في بايثون}}</noinclude>
+<noinclude>{{DISPLAYTITLE:وحدة <code>calendar‎</code> في بايثون}}</noinclude>
 تتيح هذه الوحدة الحصول على تقاويم مشابهة لمخرجات البرنامج cal في أنظمة يونكس، إلى جانب أنّها تقدّم عددًا من التوابع المفيدة والخاصة بالتقاويم. يبدأ الأسبوع في هذه التقاويم بصورة افتراضية بيوم الإثنين، وينتهي بيوم الأحد (هذا هو السائد في أوروبا).
-يمكن استخدام الدالة setfirsweekday()‎ لجعل الأسبوع يبدأ بيوم الأحد (6) أو أي يوم آخر. تكون المعاملات التي تحدّد التواريخ أعدادًا صحيحة. تقدّم بايثون وحدتين إضافيتين للتعامل مع الوقت والتاريخ هما datetime و time.
+يمكن استخدام الدالة <code>[[Python/calendar/setfirstweekday|setfirstweekday()‎]]</code> لجعل الأسبوع يبدأ بيوم الأحد (6) أو أي يوم آخر. تكون المعاملات التي تحدّد التواريخ أعدادًا صحيحة. تقدّم بايثون وحدتين إضافيتين للتعامل مع الوقت والتاريخ هما <code>[[Python/datetime|datetime]]</code> و <code>[[Python/time|time]]</code>.
-تستخدم الدوال والأصناف المعرّفة في هذه الوحدة تقويمًا مثاليًا، وهو التقويم الكريكوري الحالي والممتدّ في كلا الاتجاهين (الماضي والمستقبل) وإلى ما لا نهاية. يتطابق هذا التقويم مع "التقويم التنبؤي" والذي يقدّمه Dershowitz و Reingold في كتابهما "Calendrical Calculations" والذي يمثّل التقويم الأساسي والمعتمد في جميع أنظمة الحواسيب. يفسّر الصفر والسنوات ذات الأرقام السالبة كما هو موصوف في معيار ISO 8601، لتكون السنة 0 هي السنة 1 قبل الميلاد، و ‎-1 هي السنة 2 قبل الميلاد، وهكذا دواليك.
-== دوال الوحدة <code>calendar</code> ==
+تستخدم الدوال والأصناف المعرّفة في هذه الوحدة تقويمًا مثاليًا، وهو التقويم الكريكوري الحالي والممتدّ في كلا الاتجاهين (الماضي والمستقبل) وإلى ما لا نهاية. يتطابق هذا التقويم مع "التقويم التنبؤي" والذي يقدّمه Dershowitz و Reingold في كتابهما "Calendrical Calculations" والذي يمثّل التقويم الأساسي والمعتمد في جميع أنظمة الحواسيب. يفسّر الصفر والسنوات ذات الأرقام السالبة كما هو موصوف في معيار ISO 8601، لتكون السنة <code>0</code> هي السنة <code>1</code> قبل الميلاد، و <code>‎-1</code> هي السنة <code>2</code> قبل الميلاد، وهكذا دواليك.
+==دوال الوحدة <code>calendar</code>==
 تقدّم وحدة <code>calendar</code> عددًا من الدوال الخاصّة بالتقاويم النصية البسيطة.
+===الدالة <code>[[Python/calendar/setfirstweekday|setfirstweekday()‎]]</code>===
+تعيّن الدالة اليوم الذي يبدأ به الأسبوع.
-=== الدالة <code>setfirstweekday()‎</code> ===
+===الدالة <code>[[Python/calendar/firstweekday|firstweekday()]]‎</code>===
+تعيد الدالة الإعدادات الحالية الخاصة باليوم الذي يبدأ به الأسبوع.
-=== الدالة <code>firstweekday()‎</code> ===
-=== الدالة <code>isleap()‎</code> ===
-=== الدالة <code>leapdays()‎</code> ===
-=== الدالة <code>weekday()‎</code> ===
-=== الدالة <code>weekheader()‎</code> ===
+===الدالة <code>[[Python/calendar/isleap|isleap()]]‎</code>===
+تخبر الدالة ما إذا كانت السنة المعطاة كبيسة أم لا.
-=== الدالة <code>monthrange()‎</code> ===
+===الدالة <code>[[Python/calendar/leapdays|leapdays()‎]]</code>===
+تعيد الدالة عدد السنوات الكبيسة ضمن نطاق السنوات المحدد.
-=== الدالة <code>monthcalendar()‎</code> ===
+===الدالة <code>[[Python/calendar/weekday|weekday()]]‎</code>===
+تعيد الدالة يوم الأسبوع في الشهر المعطى في السنة المعطاة.
-=== الدالة <code>prmonth()‎</code> ===
+===الدالة <code>[[Python/calendar/weekheader|weekheader()]]‎</code>===
+تعيد الدالة ترويسة تتضمن أسماء أيام الأسبوع بصيغة مختصرة.
-=== الدالة <code>month()‎</code> ===
+===الدالة <code>[[Python/calendar/monthrange|monthrange()‎]]</code>===
+تعيد الدالة أول يوم في الشهر وعدد أيام الشهر المعطى في السنة المعطاة.
-=== الدالة <code>prcal()‎</code> ===
+===الدالة <code>[[Python/calendar/monthcalendar|monthcalendar()‎]]</code>===
+تعيد الدالة مصفوفة matrix تمثّل تقويم الشهر.
-=== الدالة <code>calendar()‎</code> ===
+===الدالة <code>[[Python/calendar/prmonth|prmonth()‎]]</code>===
+تطبع الدالة تقويم الشهر الذي تعيده الدالة <code>month()‎</code>.
-=== الدالة <code>timegm()‎</code> ===
+===الدالة <code>[[Python/calendar/month|month()]]‎</code>===
+تعيد الدالة تقويم الشهر على هيئة سلسلة نصية متعددة الأسطر.
+===الدالة <code>[[Python/calendar/prcal|prcal()]]‎</code>===
+تطبع الدالة تقويم السنة برمّتها والذي تعيده الدالة <code>calendar()‎</code>.
-== خصائص الوحدة <code>calendar</code> ==
+===الدالة <code>[[Python/calendar/calendar|calendar()]]‎</code>===
+تعيد الدالة تقويمًا ذا ثلاثة أعمدة يتضمّن سنة كاملة وعلى هيئة سلسلة نصية متعددة الأسطر.
-تقدّم وحدة calendar الخصائص التالية:
+===الدالة <code>[[Python/calendar/timegm|timegm()]]‎</code>===
+تعيد الدالة قيمة الختم الزمني المقابل في نظام يونكس.
-=== الخاصية <code>calendar.day_name</code> ===
+==خصائص الوحدة <code>calendar</code>==
+تقدّم وحدة <code>calendar</code> الخصائص التالية:
+===الخاصية <code>calendar.day_name</code>===
 مصفوفة تعرض أيام الأسبوع في الإعدادات المحلية الحالية.
+===الخاصية <code>calendar.day_abbr</code>===
-=== الخاصية <code>calendar.day_abbr</code> ===
 مصفوفة تعرض الأسماء المختصرة لأيام الأسبوع في الإعدادات المحلية الحالية.
+===الخاصية <code>calendar.month_name</code>===
-=== الخاصية <code>calendar.month_name</code> ===
 مصفوفة تعرض أشهر السنة في الإعدادات المحلية الحالية. تتبع هذا الخاصية ما هو متعارف عليه في أن يكون شهر كانون الثاني (يناير) هو الشهر رقم 1، لذا يكون طول المصفوفة 13، وتكون month_name[0]‎ سلسلة فارغة.
+===الخاصية <code>calendar.month_abbr</code>===
-=== الخاصية <code>calendar.month_abbr</code> ===
+مصفوفة تعرض الأسماء المختصرة لأشهر السنة في الإعدادات المحلية الحالية. تتبع هذا الخاصية ما هو متعارف عليه في أن يكون شهر كانون الثاني (يناير) هو الشهر رقم <code>1</code>، لذا يكون طول المصفوفة <code>13</code>، وتكون <code>month_name[0]</code>‎ سلسلة فارغة.
+==أصناف الوحدة <code>calendar</code>==
-مصفوفة تعرض الأسماء المختصرة لأشهر السنة في الإعدادات المحلية الحالية. تتبع هذا الخاصية ما هو متعارف عليه في أن يكون شهر كانون الثاني (يناير) هو الشهر رقم 1، لذا يكون طول المصفوفة 13، وتكون month_name[0]‎ سلسلة فارغة.
-== أصناف الوحدة <code>calendar</code> ==
 تقدم وحدة <code>calendar</code> الأصناف الخمسة التالية للتعامل مع التقاويم بطرق مختلفة:
+===الصنف <code>[[Python/Calendar|Calendar]]</code>===
-=== الصنف <code>Calendar</code> ===
 يقدّم كائن Calendar عددًا من التوابع التي يمكن استخدامها لتحضير بيانات التقويم لغرض التنسيق.
+===الصنف <code>[[Python/TextCalendar|TextCalendar]]</code>===
-=== الصنف <code>TextCalendar</code> ===
 يستخدم هذا الصنف لإنشاء تقويم بهيئة نصية صرفة plain text.
+===الصنف <code>[[Python/HTMLCalendar|HTMLCalendar]]</code>===
-=== الصنف <code>HTMLCalendar</code> ===
+يمكن استخدام هذا الصنف لإنشاء تقاويم بصيغة [[HTML]].
+===الصنف <code>[[Python/LocaleTextCalendar|LocaleTextCalendar]]</code>===
-يمكن استخدام هذا الصنف لإنشاء تقاويم بصيغة HTML.
+هذا الصنف متفرّع من الصنف [[Python/TextCalendar|TextCalendar]]، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة نصية صرفة.
+===الصنف <code>[[Python/LocaleHTMLCalendar|LocaleHTMLCalendar]]</code>===
-=== الصنف <code>LocaleTextCalendar</code> ===
+هذا الصنف متفرّع من الصنف <code>[[Python/HTMLCalendar|HTMLCalendar]]</code>، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة [[HTML/div|HTML]].
+==انظر أيضًا==
-هذا الصنف متفرّع من الصنف TextCalendar، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة نصية صرفة.
+*[[Python/datetime|وحدة <code>datetime</code> في بايثون.]]
+==مصادر==
-=== الصنف <code>LocaleHTMLCalendar</code> ===
+*[https://docs.python.org/3/library/calendar.html#module-calendar صفحة General calendar-related functions في توثيق بايثون الرسمي.]
-هذا الصنف متفرّع من الصنف HTMLCalendar، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة HTML.
-== انظر أيضًا ==
-* وحدة datetime في بايثون.
-== مصادر ==
-* [https://docs.python.org/3/library/calendar.html#module-calendar صفحة General calendar-related functions في توثيق بايثون الرسمي.]
 [[تصنيف:Python]]
 [[تصنيف:Python Modules]]

المراجعة الحالية بتاريخ 08:26، 4 أغسطس 2018

دوال الوحدة calendar

الدالة setfirstweekday()‎

الدالة firstweekday()‎

الدالة isleap()‎

الدالة leapdays()‎

الدالة weekday()‎

الدالة weekheader()‎

الدالة monthrange()‎

الدالة monthcalendar()‎

الدالة prmonth()‎

الدالة month()‎

الدالة prcal()‎

الدالة calendar()‎

الدالة timegm()‎

خصائص الوحدة calendar

الخاصية calendar.day_name

الخاصية calendar.day_abbr

الخاصية calendar.month_name

الخاصية calendar.month_abbr

أصناف الوحدة calendar

الصنف Calendar

الصنف TextCalendar

الصنف HTMLCalendar

الصنف LocaleTextCalendar

الصنف LocaleHTMLCalendar