الفرق بين المراجعتين لصفحة: «Python/Calendar»
لا ملخص تعديل |
لا ملخص تعديل |
||
| (2 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 21: | سطر 21: | ||
تقدّم نسخ الصنف <code>Calendar</code> التوابع التالية: | تقدّم نسخ الصنف <code>Calendar</code> التوابع التالية: | ||
=== التابع <code>() | === التابع <code>[[Python/Calendar/iterweekdays|iterweekdays()]]</code> === | ||
يعيد التابع كائن تكرار iterator لأرقام أيام الأسبوع التي ستستخدم لأسبوع واحد. | يعيد التابع كائن تكرار iterator لأرقام أيام الأسبوع التي ستستخدم لأسبوع واحد. | ||
=== التابع <code>() | === التابع <code>[[Python/Calendar/itermonthdates|itermonthdates()]]</code> === | ||
يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة. | يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة. | ||
=== التابع <code>() | === التابع <code>[[Python/Calendar/itermonthdays|itermonthdays()]]</code> === | ||
يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق <code>[[Python/datetime/date|datetime.date]]</code>، وتعاد الأيام على هيئة أعداد صحيحة. | يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق <code>[[Python/datetime/date|datetime.date]]</code>، وتعاد الأيام على هيئة أعداد صحيحة. | ||
=== التابع <code>() | === التابع <code>[[Python/Calendar/itermonthdays2|itermonthdays2()]]</code> === | ||
يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق <code>[[Python/datetime/date|datetime.date]]</code>، وتعاد الأيام على هيئة صفوف تتضمن رقم اليوم في الشهر ورقم اليوم في الأسبوع. | يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق <code>[[Python/datetime/date|datetime.date]]</code>، وتعاد الأيام على هيئة صفوف تتضمن رقم اليوم في الشهر ورقم اليوم في الأسبوع. | ||
. | . | ||
=== التابع <code>() | === التابع <code>[[Python/Calendar/itermonthdays3|itermonthdays3()]]</code> === | ||
يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق <code>[[Python/datetime/date|datetime.date]]</code>، وتعاد الأيام على هيئة صفوف تتضمن رقم السنة والشهر ويوم الأسبوع. | يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق <code>[[Python/datetime/date|datetime.date]]</code>، وتعاد الأيام على هيئة صفوف تتضمن رقم السنة والشهر ويوم الأسبوع. | ||
=== التابع <code>() | === التابع <code>[[Python/Calendar/itermonthdays4|itermonthdays4()]]</code> === | ||
يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق <code>[[Python/datetime/date|datetime.date]]</code>، وتعاد الأيام على هيئة صفوف تتضمّن رقم السنة، ورقم الشهر، ورقم اليوم في الشهر، ورقم اليوم في الأسبوع. | يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق <code>[[Python/datetime/date|datetime.date]]</code>، وتعاد الأيام على هيئة صفوف تتضمّن رقم السنة، ورقم الشهر، ورقم اليوم في الشهر، ورقم اليوم في الأسبوع. | ||
=== التابع <code>() | === التابع <code>[[Python/Calendar/monthdatescalendar|monthdatescalendar()]]</code> === | ||
يعيد التابع قائمة بالأسابيع في الشهر المعطى في السنة المعطاة على هيئة قوائم تتضمّن سبعة كائنات <code>[[Python/datetime/date|datetime.date]]</code>. | يعيد التابع قائمة بالأسابيع في الشهر المعطى في السنة المعطاة على هيئة قوائم تتضمّن سبعة كائنات <code>[[Python/datetime/date|datetime.date]]</code>. | ||
=== التابع <code>() | === التابع <code>[[Python/Calendar/monthdays2calendar|monthdays2calendar()]]</code> === | ||
يعيد التابع قائمة بالأسابيع في الشهر المعطى في السنة المعطاة على هيئة قوائم مكوّنة من سبعة صفوف تضمّ بدورها أرقام الأيام وأرقام أيام الأسبوع. | يعيد التابع قائمة بالأسابيع في الشهر المعطى في السنة المعطاة على هيئة قوائم مكوّنة من سبعة صفوف تضمّ بدورها أرقام الأيام وأرقام أيام الأسبوع. | ||
=== التابع <code>() | |||
=== التابع <code>[[Python/Calendar/monthdayscalendar|monthdayscalendar()]]</code> === | |||
يعيد التابع قائمة بالأسابيع في الشهر المعطى في السنة المعطاة على هيئة قوائم تضمّ أرقام الأيام السبعة. | يعيد التابع قائمة بالأسابيع في الشهر المعطى في السنة المعطاة على هيئة قوائم تضمّ أرقام الأيام السبعة. | ||
=== التابع <code>() | === التابع <code>[[Python/Calendar/yeardatescalendar|yeardatescalendar()]]</code> === | ||
يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون هذه البيانات جاهزة للتنسيق. | يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون هذه البيانات جاهزة للتنسيق. | ||
=== التابع <code>() | === التابع <code>[[Python/Calendar/yeardays2calendar|yeardays2calendar()]]</code> === | ||
يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون البيانات جاهزة للتنسيق، وتكون العناصر في قوائم الأسابيع عبارة عن صفوف تتضمّن أعداد الأيام وأعداد أيام الأسبوع. | يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون البيانات جاهزة للتنسيق، وتكون العناصر في قوائم الأسابيع عبارة عن صفوف تتضمّن أعداد الأيام وأعداد أيام الأسبوع. | ||
=== التابع <code>() | === التابع <code>[[Python/Calendar/yeardayscalendar|yeardayscalendar()]]</code> === | ||
يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون البيانات جاهزة للتنسيق، وتكون العناصر في قوائم الأسابيع عبارة عن صفوف تتضمّن أعداد الأيام. | يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون البيانات جاهزة للتنسيق، وتكون العناصر في قوائم الأسابيع عبارة عن صفوف تتضمّن أعداد الأيام. | ||
| سطر 61: | سطر 62: | ||
* كائنات <code>[[Python/HTMLCalendar|HTMLCalendar]]</code>: يستخدم هذا الصنف لإنشاء تقويم بهيئة [[HTML]]. | * كائنات <code>[[Python/HTMLCalendar|HTMLCalendar]]</code>: يستخدم هذا الصنف لإنشاء تقويم بهيئة [[HTML]]. | ||
* كائنات <code>[[Python/LocaleTextCalendar|LocaleTextCalendar]]</code>: هذا الصنف متفرّع من الصنف <code>[[Python/TextCalendar|TextCalendar]]</code>، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة نصية صرفة. | * كائنات <code>[[Python/LocaleTextCalendar|LocaleTextCalendar]]</code>: هذا الصنف متفرّع من الصنف <code>[[Python/TextCalendar|TextCalendar]]</code>، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة نصية صرفة. | ||
* كائنات <code>[[Python/ | * كائنات <code>[[Python/LocaleHTMLCalendar|LocaleHTMLCalendar]]</code>: هذا الصنف متفرّع من الصنف <code>[[Python/HTMLCalendar|HTMLCalendar]]</code>، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة [[HTML]]. | ||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 19:09، 5 أغسطس 2018
يقدّم كائن 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 في توثيق بايثون الرسمي.