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

 الدالة () prcal في بايثون

تعريفها

تستخدم لطباعة تقويم سنة معينة.



بناؤها

                  prcal.calendar(year, w=0, l=0, c=6, m=3)
  


باراميترات

  • الباراميتر year نمرر له رقم يمثل السنة التي نريد طباعة تقويمها.

  • الباراميتر w يمكنك أن تغير قيمته الإفتراضية لتحديد حجم المسافة الفارغة بين كل يومين في التقويم.

  • الباراميتر l يمكنك أن تغير قيمته الإفتراضية لتحديد عدد الأسطر الفارغة تحت كل شهر في التقويم.

  • الباراميتر c يمكنك أن تغير قيمته الإفتراضية لتحديد حجم المسافة الفارغة بين كل شهرين في التقويم.

  • الباراميتر m يمكنك أن تغير قيمته الإفتراضية لتحديد تقويم كل شهر سيتم عرض على نفس المستوى لأنه إفتراضياً يتم عرض تقويم كل ثلاثة أشهر بجانب بعضهم.



قيمة الإرجاع

لا ترجع قيمة.



المثال الأول

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
    


المثال الثاني

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

      # لعرض تقويم سنة 2018. مع تحديد أننا نريد عرض كل 4 أشهر بجانب بعض calendar من الكلاس prcal() هنا قمنا باستدعاء الدالة
      calendar.prcal(2018, m=4)
    

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

                    2018

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

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

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

 الدالة () isleap في بايثون

تعريفها

تستخدم لمعرفة ما إذا كانت السنة كبيسة أم لا.



بناؤها

                  calendar.isleap(year)
  


باراميترات

year نمرر مكانه رقم يمثل السنة التي نريد معرفة إن كانت كبيسة أم لا.



قيمة الإرجاع

ترجع True في حال كانت قيمة year تمثل سنة كبيسة.
غير ذلك ترجع False.


مثال

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

      # لمعرفة ما إن كانت السنوات 2018, 2019 و 2020 هي سنوات كبيسة أم لا, و من ثم عرضنا ما سترجعه في كل مرة calendar من الكلاس isleap() هنا قمنا باستدعاء الدالة
      print(calendar.isleap(2018))
      print(calendar.isleap(2019))
      print(calendar.isleap(2020))
    

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

False
False
True

 الدالة () leapdays في بايثون

تعريفها

ترجع عدد السنوات الكبيسة الموجودة من سنة إلى سنة محددة.



بناؤها

                  calendar.leapdays(y1, y2)
  


باراميترات

  • مكان الباراميتر y1 نمرر رقم السنة التي نريد أن نبدأ من عندها.

  • مكان الباراميتر y2 نمرر رقم السنة التي نريد أن نتوقف قبلها.



قيمة الإرجاع

ترجع عدد السنوات الكبيسة الموجودة من سنة إلى سنة محددة.


مثال

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

      # لمعرفة عدد السنوات الكبيسة الموجودة من عام 2000 إلى ما قبل العام 2018. و من ثم عرضنا العدد الذي سترجعه leapdays() هنا قمنا باستدعاء الدالة
      print(calendar.leapdays(2000, 2018))
    

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

5

 الدالة () setfirstweekday في بايثون

تعريفها

إفتراضياً, عند عرض التقويم فإنه يظهر يوم الإثنين ( Monday ) كأول يوم في الأسبوع.
هذه الدالة تستخدم لتحديد أول يوم سيبدأ به كل أسبوع.



بناؤها

                  calendar.setfirstweekday(weekday)
  


باراميترات

مكان الباراميتر weekday نمرر إحدى ثوابت الكلاس calendar التي تشير إلى إسم اليوم أو Index الثابت:

  • calendar.MONDAY أو 0 لتعيين الإثنين كأول يوم في الأسبوع.

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

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

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

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

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

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



قيمة الإرجاع

لا ترجع قيمة.


أخطاء محتملة

ترمي الإستثناء calendar.IllegalWeekdayError في حال قمت بتمرير رقم خارج عن النطاق 0 <= weekday &tl;= 6.


مثال

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

      # لتعيين يوم الأحد كأول يوم في أيام الأسبوع calendar.SUNDAY و تمرير الثابت setfirstweekday() هنا قمنا باستدعاء الدالة
      calendar.setfirstweekday(calendar.SUNDAY)

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

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

                    2018

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

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

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

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