الفرق بين المراجعتين لصفحة: «Python/LocaleTextCalendar»
< Python
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:كائنات <code>LocaleTextCalendar</code> في بايثون}}</noinclude> هذا الصنف متفرّع من الصنف TextCalendar....' |
لا ملخص تعديل |
||
| (2 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:كائنات <code>LocaleTextCalendar</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:كائنات <code>LocaleTextCalendar</code> في بايثون}}</noinclude> | ||
هذا الصنف متفرّع من الصنف TextCalendar. يمكن تمرير اسم المنطقة في المعامل locale إلى الدالة البانية وستعيد الدالة أسماء الأشهر وأيام الأسبوع حسب المنطقة المحدّدة. إن تضمّنت المنطقة ترميزًا خاصًّا فإنّ جميع السلاسل النصية التي تتضمّن أسماء الأشهر وأيام الأسبوع ستعاد بالترميز unicode. | هذا الصنف متفرّع من الصنف <code>[[Python/TextCalendar|TextCalendar]]</code>. يمكن تمرير اسم المنطقة في المعامل <code>locale</code> إلى الدالة البانية وستعيد الدالة أسماء الأشهر وأيام الأسبوع حسب المنطقة المحدّدة. إن تضمّنت المنطقة ترميزًا خاصًّا فإنّ جميع السلاسل النصية التي تتضمّن أسماء الأشهر وأيام الأسبوع ستعاد بالترميز <code>unicode</code>. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 9: | سطر 9: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | |||
===<code>firstweekday</code>=== | |||
المعامل <code>firstweekday</code> هو عدد صحيح يحدّد اليوم الأول في الأسبوع. يمثّل العدد <code>0</code> يوم الإثنين (وهو القيمة الافتراضية) والعدد <code>6</code> هو يوم الأحد. | |||
=== <code>locale</code> === | |||
سلسلة نصية تتضمن اسم الإعدادات المحلية المطلوب استخدامها لعرض التقويم الذي تنتجه توابع هذا الصنف. | |||
== ملاحظة== | |||
يغيّر التابعان <code>formatweekday()</code> و <code>formatmonthname()</code> في هذا الصنف الإعدادات المحليّة بصورة مؤقتة إلى الإعدادات المحلية المعطاة. ونظرًا لكون الإعدادات المحلية الحالية من الإعدادات المرتبطة بالعملية ككل process-wide setting، فإنّها لن تكون عملية ذات خيوط سليمة thread-safe. | |||
== أمثلة == | == أمثلة == | ||
| سطر 42: | سطر 50: | ||
* كائنات <code>[[Python/TextCalendar|TextCalendar]]</code>: يستخدم هذا الصنف لإنشاء تقويم بهيئة نصية صرفة plain text. | * كائنات <code>[[Python/TextCalendar|TextCalendar]]</code>: يستخدم هذا الصنف لإنشاء تقويم بهيئة نصية صرفة plain text. | ||
* كائنات <code>[[Python/HTMLCalendar|HTMLCalendar]]</code>: يستخدم هذا الصنف لإنشاء تقويم بهيئة [[HTML]]. | * كائنات <code>[[Python/HTMLCalendar|HTMLCalendar]]</code>: يستخدم هذا الصنف لإنشاء تقويم بهيئة [[HTML]]. | ||
* كائنات <code>[[Python/ | * كائنات <code>[[Python/LocaleHTMLCalendar|LocaleHTMLCalendar]]</code>: هذا الصنف متفرّع من الصنف <code>[[Python/HTMLCalendar|HTMLCalendar]]</code>، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة [[HTML]]. | ||
== مصادر == | == مصادر == | ||
* [https://docs.python.org/3/library/calendar.html#calendar. | * [https://docs.python.org/3/library/calendar.html#calendar.LocaleTextCalendar صفحة General calendar-related functions في توثيق بايثون الرسمي.] | ||
[[تصنيف:Python]] | [[تصنيف:Python]] | ||
[[تصنيف:Python Modules]] | [[تصنيف:Python Modules]] | ||
[[تصنيف:Python Types]] | [[تصنيف:Python Types]] | ||
المراجعة الحالية بتاريخ 19:17، 5 أغسطس 2018
هذا الصنف متفرّع من الصنف TextCalendar. يمكن تمرير اسم المنطقة في المعامل locale إلى الدالة البانية وستعيد الدالة أسماء الأشهر وأيام الأسبوع حسب المنطقة المحدّدة. إن تضمّنت المنطقة ترميزًا خاصًّا فإنّ جميع السلاسل النصية التي تتضمّن أسماء الأشهر وأيام الأسبوع ستعاد بالترميز unicode.
البنية العامة
calendar.LocaleTextCalendar(firstweekday=0, locale=None)
المعاملات
firstweekday
المعامل firstweekday هو عدد صحيح يحدّد اليوم الأول في الأسبوع. يمثّل العدد 0 يوم الإثنين (وهو القيمة الافتراضية) والعدد 6 هو يوم الأحد.
locale
سلسلة نصية تتضمن اسم الإعدادات المحلية المطلوب استخدامها لعرض التقويم الذي تنتجه توابع هذا الصنف.
ملاحظة
يغيّر التابعان formatweekday() و formatmonthname() في هذا الصنف الإعدادات المحليّة بصورة مؤقتة إلى الإعدادات المحلية المعطاة. ونظرًا لكون الإعدادات المحلية الحالية من الإعدادات المرتبطة بالعملية ككل process-wide setting، فإنّها لن تكون عملية ذات خيوط سليمة thread-safe.
أمثلة
يبين المثال التالي النتائج المعادة من استخدام توابع هذا الصنف مع إعدادات محلية مختلفة:
>>> from calendar import LocaleTextCalendar
>>> cal = LocaleTextCalendar(locale='ar_IQ')
>>> cal.prmonth(2018, 8)
آب 2018
ن ث ر خ ج س ح
1 2 3 4 5
6 7 8 9 10 11 12
13 14 15 16 17 18 19
20 21 22 23 24 25 26
27 28 29 30 31
>>> cal = LocaleTextCalendar(locale='fr_FR')
>>> cal.prmonth(2018, 8)
août 2018
lu ma me je ve sa di
1 2 3 4 5
6 7 8 9 10 11 12
13 14 15 16 17 18 19
20 21 22 23 24 25 26
27 28 29 30 31
انظر أيضًا
- كائنات
Calendar: يقدّم هذا الصنف عددًا من التوابع التي يمكن استخدامها لتحضير بيانات التقويم لغرض التنسيق. - كائنات
TextCalendar: يستخدم هذا الصنف لإنشاء تقويم بهيئة نصية صرفة plain text. - كائنات
HTMLCalendar: يستخدم هذا الصنف لإنشاء تقويم بهيئة HTML. - كائنات
LocaleHTMLCalendar: هذا الصنف متفرّع من الصنفHTMLCalendar، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة HTML.