Python/Calendar

يقدّم كائن Calendar في وحدة calendar عددًا من التوابع التي يمكن استخدامها لتحضير بيانات التقويم لغرض التنسيق. وتجدر الإشارة هنا إلى أنّ هذا الصنف لا يؤدي أي عمليات تنسيق، وأنّ هذه العمليات تقع على عاتق الأصناف الفرعية.

البنية العامة

calendar.Calendar(firstweekday=0)

تنشئ هذه الدالة البانية كائن Calendar جديد.

المعاملات

firstweekday

المعامل firstweekday هو عدد صحيح يحدّد اليوم الأول في الأسبوع. يمثّل العدد 0 يوم الإثنين (وهو القيمة الافتراضية) والعدد 6 هو يوم الأحد.

توابع الصنف Calendar

تقدّم نسخ الصنف Calendar التوابع التالية:

التابع ()‎iterweekdays

يعيد التابع كائن تكرار iterator لأرقام أيام الأسبوع التي ستستخدم لأسبوع واحد.

التابع ()‎itermonthdates

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

التابع ()‎itermonthdays

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime.date، وتعاد الأيام على هيئة أعداد صحيحة.

التابع ()‎itermonthdays2

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime.date، وتعاد الأيام على هيئة صفوف تتضمن رقم اليوم في الشهر ورقم اليوم في الأسبوع. .

التابع ()‎itermonthdays3

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime.date، وتعاد الأيام على هيئة صفوف تتضمن رقم السنة والشهر ويوم الأسبوع.

التابع ()‎itermonthdays4

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime.date، وتعاد الأيام على هيئة صفوف تتضمّن رقم السنة، ورقم الشهر، ورقم اليوم في الشهر، ورقم اليوم في الأسبوع.

التابع ()‎monthdatescalendar

يعيد التابع قائمة بالأسابيع في الشهر المعطى في السنة المعطاة على هيئة قوائم تتضمّن سبعة كائنات datetime.date.

التابع ()‎monthdays2calendar

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

التابع ()‎monthdayscalendar

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

التابع ()‎yeardatescalendar

يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون هذه البيانات جاهزة للتنسيق.

التابع ()‎yeardays2calendar

يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون البيانات جاهزة للتنسيق، وتكون العناصر في قوائم الأسابيع عبارة عن صفوف تتضمّن أعداد الأيام وأعداد أيام الأسبوع.

التابع ()‎yeardayscalendar

يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون البيانات جاهزة للتنسيق، وتكون العناصر في قوائم الأسابيع عبارة عن صفوف تتضمّن أعداد الأيام.

انظر أيضًا

• كائنات TextCalendar: يستخدم هذا الصنف لإنشاء تقويم بهيئة نصية صرفة plain text.
• كائنات HTMLCalendar: يستخدم هذا الصنف لإنشاء تقويم بهيئة HTML.
• كائنات LocaleTextCalendar: هذا الصنف متفرّع من الصنف TextCalendar، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة نصية صرفة.
• كائنات LocaleHTMLCalendar: هذا الصنف متفرّع من الصنف HTMLCalendar، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة HTML.

مصادر

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