كائنات calendar.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 في توثيق بايثون الرسمي.