الفرق بين المراجعتين ل"Python/Calendar"
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:كائنات <code>calendar.Calendar</code> في بايثون}}</noinclude> يقدّم كائن Calendar في وحدة calendar عددًا...') |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:كائنات <code>calendar.Calendar</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:كائنات <code>calendar.Calendar</code> في بايثون}}</noinclude> | ||
| − | يقدّم كائن Calendar في وحدة calendar عددًا من التوابع التي يمكن استخدامها لتحضير بيانات التقويم لغرض التنسيق. وتجدر الإشارة هنا إلى أنّ هذا الصنف لا يؤدي أي عمليات تنسيق، وأنّ هذه العمليات تقع على عاتق الأصناف الفرعية. | + | يقدّم كائن <code>Calendar</code> في وحدة <code>calendar</code> عددًا من التوابع التي يمكن استخدامها لتحضير بيانات التقويم لغرض التنسيق. وتجدر الإشارة هنا إلى أنّ هذا الصنف لا يؤدي أي عمليات تنسيق، وأنّ هذه العمليات تقع على عاتق الأصناف الفرعية. |
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
| − | + | calendar.Calendar(firstweekday=0) | |
</syntaxhighlight> | </syntaxhighlight> | ||
| − | تنشئ هذه الدالة البانية كائن Calendar. | + | تنشئ هذه الدالة البانية كائن <code>Calendar</code> جديد. |
== المعاملات == | == المعاملات == | ||
| − | === <code> | + | === <code>firstweekday</code> === |
| − | المعامل <code> | + | المعامل <code>firstweekday</code> هو عدد صحيح يحدّد اليوم الأول في الأسبوع. يمثّل العدد <code>0</code> يوم الإثنين (وهو القيمة الافتراضية) والعدد <code>6</code> هو يوم الأحد. |
== توابع الصنف Calendar == | == توابع الصنف Calendar == | ||
| − | تقدّم نسخ الصنف Calendar التوابع التالية: | + | تقدّم نسخ الصنف <code>Calendar</code> التوابع التالية: |
| − | === التابع <code> | + | === التابع <code>()iterweekdays</code> === |
يعيد التابع كائن تكرار iterator لأرقام أيام الأسبوع التي ستستخدم لأسبوع واحد. | يعيد التابع كائن تكرار iterator لأرقام أيام الأسبوع التي ستستخدم لأسبوع واحد. | ||
| − | === التابع <code> | + | === التابع <code>()itermonthdates</code> === |
يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة. | يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة. | ||
| − | === التابع <code> | + | === التابع <code>()itermonthdays</code> === |
| − | يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime. | + | يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق <code>[[Python/datetime/date|datetime.date]]</code>، وتعاد الأيام على هيئة أعداد صحيحة. |
| − | === التابع <code> | + | === التابع <code>()itermonthdays2</code> === |
| − | يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime. | + | يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق <code>[[Python/datetime/date|datetime.date]]</code>، وتعاد الأيام على هيئة صفوف تتضمن رقم اليوم في الشهر ورقم اليوم في الأسبوع. |
. | . | ||
| − | === التابع <code> | + | === التابع <code>()itermonthdays3</code> === |
| − | يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime. | + | يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق <code>[[Python/datetime/date|datetime.date]]</code>، وتعاد الأيام على هيئة صفوف تتضمن رقم السنة والشهر ويوم الأسبوع. |
| − | === التابع <code> | + | === التابع <code>()itermonthdays4</code> === |
| − | يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime. | + | يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق <code>[[Python/datetime/date|datetime.date]]</code>، وتعاد الأيام على هيئة صفوف تتضمّن رقم السنة، ورقم الشهر، ورقم اليوم في الشهر، ورقم اليوم في الأسبوع. |
| − | === التابع <code> | + | === التابع <code>()monthdatescalendar</code> === |
| − | يعيد التابع قائمة بالأسابيع في الشهر المعطى في السنة المعطاة على هيئة قوائم تتضمّن سبعة كائنات datetime.date. | + | يعيد التابع قائمة بالأسابيع في الشهر المعطى في السنة المعطاة على هيئة قوائم تتضمّن سبعة كائنات <code>[[Python/datetime/date|datetime.date]]</code>. |
| − | === التابع <code> | + | === التابع <code>()monthdays2calendar</code> === |
يعيد التابع قائمة بالأسابيع في الشهر المعطى في السنة المعطاة على هيئة قوائم مكوّنة من سبعة صفوف تضمّ بدورها أرقام الأيام وأرقام أيام الأسبوع. | يعيد التابع قائمة بالأسابيع في الشهر المعطى في السنة المعطاة على هيئة قوائم مكوّنة من سبعة صفوف تضمّ بدورها أرقام الأيام وأرقام أيام الأسبوع. | ||
| − | === التابع <code> | + | === التابع <code>()monthdayscalendar</code> === |
يعيد التابع قائمة بالأسابيع في الشهر المعطى في السنة المعطاة على هيئة قوائم تضمّ أرقام الأيام السبعة. | يعيد التابع قائمة بالأسابيع في الشهر المعطى في السنة المعطاة على هيئة قوائم تضمّ أرقام الأيام السبعة. | ||
| − | === التابع <code> | + | === التابع <code>()yeardatescalendar</code> === |
يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون هذه البيانات جاهزة للتنسيق. | يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون هذه البيانات جاهزة للتنسيق. | ||
| − | === التابع <code> | + | === التابع <code>()yeardays2calendar</code> === |
يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون البيانات جاهزة للتنسيق، وتكون العناصر في قوائم الأسابيع عبارة عن صفوف تتضمّن أعداد الأيام وأعداد أيام الأسبوع. | يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون البيانات جاهزة للتنسيق، وتكون العناصر في قوائم الأسابيع عبارة عن صفوف تتضمّن أعداد الأيام وأعداد أيام الأسبوع. | ||
| − | === التابع <code> | + | === التابع <code>()yeardayscalendar</code> === |
يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون البيانات جاهزة للتنسيق، وتكون العناصر في قوائم الأسابيع عبارة عن صفوف تتضمّن أعداد الأيام. | يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون البيانات جاهزة للتنسيق، وتكون العناصر في قوائم الأسابيع عبارة عن صفوف تتضمّن أعداد الأيام. | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| + | * كائنات <code>[[Python/TextCalendar|TextCalendar]]</code>: يستخدم هذا الصنف لإنشاء تقويم بهيئة نصية صرفة plain text. | ||
| + | * كائنات <code>[[Python/HTMLCalendar|HTMLCalendar]]</code>: يستخدم هذا الصنف لإنشاء تقويم بهيئة [[HTML]]. | ||
| + | * كائنات <code>[[Python/LocaleTextCalendar|LocaleTextCalendar]]</code>: هذا الصنف متفرّع من الصنف <code>[[Python/TextCalendar|TextCalendar]]</code>، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة نصية صرفة. | ||
| + | * كائنات <code>[[Python/HTMLCalendar|LocaleHTMLCalendar]]</code>: هذا الصنف متفرّع من الصنف <code>[[Python/HTMLCalendar|HTMLCalendar]]</code>، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة [[HTML]]. | ||
== مصادر == | == مصادر == | ||
[https://docs.python.org/3/library/datetime.html#caldendar.Calendar. صفحة General calendar-related functions في توثيق بايثون الرسمي.] | [https://docs.python.org/3/library/datetime.html#caldendar.Calendar. صفحة General calendar-related functions في توثيق بايثون الرسمي.] | ||
| − | |||
[[تصنيف:Python]] | [[تصنيف:Python]] | ||
[[تصنيف:Python Modules]] | [[تصنيف:Python Modules]] | ||
[[تصنيف:Python Methods]] | [[تصنيف:Python Methods]] | ||
مراجعة 08:23، 4 أغسطس 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 في توثيق بايثون الرسمي.