الدالة 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 في توثيق بايثون الرسمي.