كائنات LocaleTextCalendar‎ في بايثون

من موسوعة حسوب


هذا الصنف متفرّع من الصنف 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.

مصادر