الموديول calendar في بايثون

الموديول calendar 

الموديول calendar يحتوي على مجموعة كلاسات و دوال جاهزة للتعامل مع التقويم و لعرضه بشكل جميل جداً.
فمثلاً, يحتوي على دوال جاهزة لعرض تقويم سنة معينة أو شهر محدد في السنة.


في المثال التالي قمنا بعرض تقويم سنة 2018 بالإعتماد على الدالة prcal() الموجودة في الكلاس calendar الموجود بداخل الموديول calendar.

المثال الأول

Test.py
# calendar هنا قمنا بتضمين كل محتوى الموديول
      import calendar

      # لعرض تقويم سنة 2018 calendar من الكلاس prcal() هنا قمنا باستدعاء الدالة
      calendar.prcal(2018)
    

سنحصل على النتيجة التالية عند التشغيل.

                                  2018

      January                   February                   March
      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su
      1  2  3  4  5  6  7                1  2  3  4                1  2  3  4
      8  9 10 11 12 13 14       5  6  7  8  9 10 11       5  6  7  8  9 10 11
      15 16 17 18 19 20 21      12 13 14 15 16 17 18      12 13 14 15 16 17 18
      22 23 24 25 26 27 28      19 20 21 22 23 24 25      19 20 21 22 23 24 25
      29 30 31                  26 27 28                  26 27 28 29 30 31

      April                      May                       June
      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su
      1          1  2  3  4  5  6                   1  2  3
      2  3  4  5  6  7  8       7  8  9 10 11 12 13       4  5  6  7  8  9 10
      9 10 11 12 13 14 15      14 15 16 17 18 19 20      11 12 13 14 15 16 17
      16 17 18 19 20 21 22      21 22 23 24 25 26 27      18 19 20 21 22 23 24
      23 24 25 26 27 28 29      28 29 30 31               25 26 27 28 29 30
      30

      July                     August                  September
      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su
      1             1  2  3  4  5                      1  2
      2  3  4  5  6  7  8       6  7  8  9 10 11 12       3  4  5  6  7  8  9
      9 10 11 12 13 14 15      13 14 15 16 17 18 19      10 11 12 13 14 15 16
      16 17 18 19 20 21 22      20 21 22 23 24 25 26      17 18 19 20 21 22 23
      23 24 25 26 27 28 29      27 28 29 30 31            24 25 26 27 28 29 30
      30 31

      October                   November                  December
      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su
      1  2  3  4  5  6  7                1  2  3  4                      1  2
      8  9 10 11 12 13 14       5  6  7  8  9 10 11       3  4  5  6  7  8  9
      15 16 17 18 19 20 21      12 13 14 15 16 17 18      10 11 12 13 14 15 16
      22 23 24 25 26 27 28      19 20 21 22 23 24 25      17 18 19 20 21 22 23
      29 30 31                  26 27 28 29 30            24 25 26 27 28 29 30
      31
    

 دوال الموديل calendar

الجدول التالي يحتوي على دوال الكلاس calendar الأكثر إستخداماً.

إسم الدالة مع تعريفها
calendar.prcal(year, w=0, l=0, c=6, m=3) تستخدم لطباعة تقويم سنة معينة.
مكان الباراميتر year نمرر السنة التي نريد طباعة تقويمها.
calendar.isleap(year) تستخدم لمعرفة ما إذا كانت السنة كبيسة أم لا.
مكان الباراميتر year نمرر رقم السنة التي نريد التشييك عليها.
في حال كانت قيمة year تمثل سنة كبيسة ترجع True, إن لم تكن كذلك ترجع False.
calendar.leapdays(y1, y2) ترجع عدد السنوات الكبيسة الموجودة من سنة إلى سنة محددة.
مكان الباراميتر y1 نمرر رقم السنة التي نريد أن نبدأ من عندها.
مكان الباراميتر y2 نمرر رقم السنة التي نريد أن نتوقف قبلها.
calendar.setfirstweekday(weekday) إفتراضياً, عند عرض التقويم فإنه يظهر يوم الإثنين ( Monday ) كأول يوم في الأسبوع.
هذه الدالة تستخدم لتحديد أول يوم سيبدأ به كل أسبوع.
مكان الباراميتر weekday نمرر إحدى ثوابت الكلاس calendar التي تشير إلى إسم اليوم أو Index الثابت:
  • calendar.MONDAY أو 0 لتعيين الإثنين كأول يوم في الأسبوع.

  • calendar.TUESDAY أو 1 لتعيين الثلاثاء كأول يوم في الأسبوع.

  • calendar.WEDNESDAY أو 2 لتعيين الأربعاء كأول يوم في الأسبوع.

  • calendar.THURSDAY أو 3 لتعيين الخميس كأول يوم في الأسبوع.

  • calendar.FRIDAY أو 4 لتعيين الجمعة كأول يوم في الأسبوع.

  • calendar.SATURDAY أو 5 لتعيين السبت كأول يوم في الأسبوع.

  • calendar.SUNDAY أو 6 لتعيين الأحد كأول يوم في الأسبوع.

تعليقات