الدالة calendar.calendar()‎ في بايثون

تعيد الدالة تقويمًا ذا ثلاثة أعمدة يتضمّن سنة كاملة وعلى هيئة سلسلة نصية متعددة الأسطر.

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

calendar.calendar(year, w=2, l=1, c=6, m=3)

المعاملات

year

السنة المطلوبة.

w

معامل اختياري يأخذ القيمة الافتراضية 0، ويحدّد عرض التقويم الذي ستطبعه الدالة.

l

معامل اختياري يأخذ القيمة الافتراضية 0، ويحدّد مقدار الفاصل بين الأسطر في التقويم الذي ستطبعه الدالة.

c

معامل اختياري يأخذ القيمة الافتراضية 6، ويحدّد مقدار الفاصل بين الأعمدة في التقويم.

m

معامل اختياري يأخذ القيمة الافتراضية 3، ويحدّد عدد الأشهر في كل صفٍّ من صفوف التقويم.

القيمة المعادة

عيد الدالة تقويمًا ذا ثلاثة أعمدة يتضمّن سنة كاملة وعلى هيئة سلسلة نصية متعددة الأسطر وذلك باستخدام التابع formatyear()‎ الخاص بالصنف TextCalendar.

أمثلة

يبين المثال التالي طريقة استخدام الدالة:

>>> import calendar
>>> calendar.calendar(2018)
'                                  2018\n\n      January                   February                   March\nTu We Th Fr Sa Su Mo      Tu We Th Fr Sa Su Mo      Tu We Th Fr Sa Su Mo\n                   1             1  2  3  4  5             1  2  3  4  5\n 2  3  4  5  6  7  8       6  7  8  9 10 11 12       6  7  8  9 10 11 12\n 9 10 11 12 13 14 15      13 14 15 16 17 18 19      13 14 15 16 17 18 19\n16 17 18 19 20 21 22      20 21 22 23 24 25 26      20 21 22 23 24 25 26\n23 24 25 26 27 28 29      27 28                     27 28 29 30 31\n30 31\n\n       April                      May                       June\nTu We Th Fr Sa Su Mo      Tu We Th Fr Sa Su Mo      Tu We Th Fr Sa Su Mo\n                1  2       1  2  3  4  5  6  7                1  2  3  4\n 3  4  5  6  7  8  9       8  9 10 11 12 13 14       5  6  7  8  9 10 11\n10 11 12 13 14 15 16      15 16 17 18 19 20 21      12 13 14 15 16 17 18\n17 18 19 20 21 22 23      22 23 24 25 26 27 28      19 20 21 22 23 24 25\n24 25 26 27 28 29 30      29 30 31                  26 27 28 29 30\n\n        July                     August                  September\nTu We Th Fr Sa Su Mo      Tu We Th Fr Sa Su Mo      Tu We Th Fr Sa Su Mo\n                1  2          1  2  3  4  5  6                   1  2  3\n 3  4  5  6  7  8  9       7  8  9 10 11 12 13       4  5  6  7  8  9 10\n10 11 12 13 14 15 16      14 15 16 17 18 19 20      11 12 13 14 15 16 17\n17 18 19 20 21 22 23      21 22 23 24 25 26 27      18 19 20 21 22 23 24\n24 25 26 27 28 29 30      28 29 30 31               25 26 27 28 29 30\n31\n\n      October                   November                  December\nTu We Th Fr Sa Su Mo      Tu We Th Fr Sa Su Mo      Tu We Th Fr Sa Su Mo\n                   1             1  2  3  4  5                   1  2  3\n 2  3  4  5  6  7  8       6  7  8  9 10 11 12       4  5  6  7  8  9 10\n 9 10 11 12 13 14 15      13 14 15 16 17 18 19      11 12 13 14 15 16 17\n16 17 18 19 20 21 22      20 21 22 23 24 25 26      18 19 20 21 22 23 24\n23 24 25 26 27 28 29      27 28 29 30               25 26 27 28 29 30 31\n30 31\n'
>>> calendar.calendar(2018, 2, 2, 3, 4)
'                                           2018\n\n\n\n      January                February                March                  April\n\nTu 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 Mo\n\n                   1          1  2  3  4  5          1  2  3  4  5                   1  2\n\n 2  3  4  5  6  7  8    6  7  8  9 10 11 12    6  7  8  9 10 11 12    3  4  5  6  7  8  9\n\n 9 10 11 12 13 14 15   13 14 15 16 17 18 19   13 14 15 16 17 18 19   10 11 12 13 14 15 16\n\n16 17 18 19 20 21 22   20 21 22 23 24 25 26   20 21 22 23 24 25 26   17 18 19 20 21 22 23\n\n23 24 25 26 27 28 29   27 28                  27 28 29 30 31         24 25 26 27 28 29 30\n\n30 31\n\n\n\n        May                    June                   July                  August\n\nTu 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 Mo\n\n 1  2  3  4  5  6  7             1  2  3  4                   1  2       1  2  3  4  5  6\n\n 8  9 10 11 12 13 14    5  6  7  8  9 10 11    3  4  5  6  7  8  9    7  8  9 10 11 12 13\n\n15 16 17 18 19 20 21   12 13 14 15 16 17 18   10 11 12 13 14 15 16   14 15 16 17 18 19 20\n\n22 23 24 25 26 27 28   19 20 21 22 23 24 25   17 18 19 20 21 22 23   21 22 23 24 25 26 27\n\n29 30 31               26 27 28 29 30         24 25 26 27 28 29 30   28 29 30 31\n\n                                              31\n\n\n\n     September               October                November               December\n\nTu 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 Mo\n\n             1  2  3                      1          1  2  3  4  5                1  2  3\n\n 4  5  6  7  8  9 10    2  3  4  5  6  7  8    6  7  8  9 10 11 12    4  5  6  7  8  9 10\n\n11 12 13 14 15 16 17    9 10 11 12 13 14 15   13 14 15 16 17 18 19   11 12 13 14 15 16 17\n\n18 19 20 21 22 23 24   16 17 18 19 20 21 22   20 21 22 23 24 25 26   18 19 20 21 22 23 24\n\n25 26 27 28 29 30      23 24 25 26 27 28 29   27 28 29 30            25 26 27 28 29 30 31\n\n                       30 31\n\n'

انظر أيضًا

• الدالة prmonth()‎: تطبع الدالة تقويم الشهر الذي تعيده الدالة month()‎.
• الدالة prcal()‎: تطبع الدالة تقويم السنة كاملة والذي تعيده الدالة calendar()‎.

مصادر

صفحة General calendar-related functions في توثيق بايثون الرسمي.