عرض مصدر Python/LocaleTextCalendar

<noinclude>{{DISPLAYTITLE:كائنات <code>LocaleTextCalendar‎</code> في بايثون}}</noinclude>

هذا الصنف متفرّع من الصنف <code>[[Python/TextCalendar|TextCalendar]]</code>. يمكن تمرير اسم المنطقة في المعامل <code>locale</code> إلى الدالة البانية وستعيد الدالة أسماء الأشهر وأيام الأسبوع حسب المنطقة المحدّدة. إن تضمّنت المنطقة ترميزًا خاصًّا فإنّ جميع السلاسل النصية التي تتضمّن أسماء الأشهر وأيام الأسبوع ستعاد بالترميز <code>unicode</code>.

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

<syntaxhighlight lang="python3">
‎calendar.LocaleTextCalendar(firstweekday=0, locale=None)
</syntaxhighlight>

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

=== <code>locale</code> ===
سلسلة نصية تتضمن اسم الإعدادات المحلية المطلوب استخدامها لعرض التقويم الذي تنتجه توابع هذا الصنف.

== أمثلة ==

يبين المثال التالي النتائج المعادة من استخدام توابع هذا الصنف مع إعدادات محلية مختلفة:

<syntaxhighlight lang="python3">
‎>>> 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

</syntaxhighlight>

== انظر أيضًا ==

* كائنات <code>[[Python/Calendar|Calendar]]</code>: يقدّم هذا الصنف عددًا من التوابع التي يمكن استخدامها لتحضير بيانات التقويم لغرض التنسيق.
* كائنات <code>[[Python/TextCalendar|TextCalendar]]</code>: يستخدم هذا الصنف لإنشاء تقويم بهيئة نصية صرفة plain text.
* كائنات <code>[[Python/HTMLCalendar|HTMLCalendar]]</code>: يستخدم هذا الصنف لإنشاء تقويم بهيئة [[HTML]].
* كائنات <code>[[Python/LocaleHTMLCalendar|LocaleHTMLCalendar]]</code>: هذا الصنف متفرّع من الصنف <code>[[Python/HTMLCalendar|HTMLCalendar]]</code>، ويستخدم لعرض التقويم بحسب الإعدادات المحلية وبهيئة [[HTML]].

== مصادر ==

* [https://docs.python.org/3/library/calendar.html#calendar.LocaleTextCalendar صفحة General calendar-related functions في توثيق بايثون الرسمي.]

[[تصنيف:Python]]
[[تصنيف:Python Modules]]
[[تصنيف:Python Types]]