عرض مصدر Python/TextCalendar/formatyear

<noinclude>{{DISPLAYTITLE:التابع <code>TextCalendar.formatyear()‎</code> في بايثون}}</noinclude>

يعيد التابع التقويم الخاص بشهر معيّن على هيئة سلسلة نصية متعددة الأسطر.

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

<syntaxhighlight lang="python3">
formatyear(theyear, w=2, l=1, c=6, m=3)
</syntaxhighlight>

== المعاملات ==

===<code>theyear</code>===
السنة المطلوبة.
===<code>w</code> ===
معامل اختياري يحدّد عرض عمود التاريخ، ويأخذ القيمة الافتراضية 2.
===<code>l</code> ===
معامل اختياري يحدّد عدد الأسطر لكل أسبوع، ويأخذ القيمة الافتراضية 1.
===<code>c</code> ===
معامل اختياري يحدّد عدد الفراغات بين أعمدة الشهر.
===<code>m</code> ===
معامل اختياري يحدّد عدد أعمدة التقويم، ويأخذ القيمة الافتراضية 3.

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

يعيد التابع العدد المحدّد من أعمدة التقويم لسنة كاملة على هيئة سلسلة نصية متعددة الأسطر. 

يعتمد التابع في تحديد اليوم الأول من الأسبوع على القيمة المحدّدة في الدالة البانية أو المعيّنة بواسطة التابع <code>[[Python/calendar/setfirstweekday|setfirstweekday()‎]]</code>. 

يعتمد قدم التقويم الذي يمكن لهذا التابع إنتاجه على المنصّة التي تعمل عليها الشيفرة.
== أمثلة ==

يبين المثال التالي آلية عمل التابع:

<syntaxhighlight lang="python3">
>>> from calendar import TextCalendar
>>> tcal = TextCalendar()
>>> tcal.formatyear(2018)
'                                  2018\n\n      January                   February                   March\nMo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su\n 1  2  3  4  5  6  7                1  2  3  4                1  2  3  4\n 8  9 10 11 12 13 14       5  6  7  8  9 10 11       5  6  7  8  9 10 11\n15 16 17 18 19 20 21      12 13 14 15 16 17 18      12 13 14 15 16 17 18\n22 23 24 25 26 27 28      19 20 21 22 23 24 25      19 20 21 22 23 24 25\n29 30 31                  26 27 28                  26 27 28 29 30 31\n\n       April                      May                       June\nMo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su\n                   1          1  2  3  4  5  6                   1  2  3\n 2  3  4  5  6  7  8       7  8  9 10 11 12 13       4  5  6  7  8  9 10\n 9 10 11 12 13 14 15      14 15 16 17 18 19 20      11 12 13 14 15 16 17\n16 17 18 19 20 21 22      21 22 23 24 25 26 27      18 19 20 21 22 23 24\n23 24 25 26 27 28 29      28 29 30 31               25 26 27 28 29 30\n30\n\n        July                     August                  September\nMo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su\n                   1             1  2  3  4  5                      1  2\n 2  3  4  5  6  7  8       6  7  8  9 10 11 12       3  4  5  6  7  8  9\n 9 10 11 12 13 14 15      13 14 15 16 17 18 19      10 11 12 13 14 15 16\n16 17 18 19 20 21 22      20 21 22 23 24 25 26      17 18 19 20 21 22 23\n23 24 25 26 27 28 29      27 28 29 30 31            24 25 26 27 28 29 30\n30 31\n\n      October                   November                  December\nMo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su\n 1  2  3  4  5  6  7                1  2  3  4                      1  2\n 8  9 10 11 12 13 14       5  6  7  8  9 10 11       3  4  5  6  7  8  9\n15 16 17 18 19 20 21      12 13 14 15 16 17 18      10 11 12 13 14 15 16\n22 23 24 25 26 27 28      19 20 21 22 23 24 25      17 18 19 20 21 22 23\n29 30 31                  26 27 28 29 30            24 25 26 27 28 29 30\n                                                    31\n'

</syntaxhighlight>

== انظر أيضًا ==
* التابع [[Python/TextCalendar/pryear|<code>pryear</code>()‎]]: يطبع التابع التقويم لسنة كاملة وبحسب ما يعيده التابع <code>formatyear()‎</code>.

== مصادر ==
[https://docs.python.org/3/library/calendar.html#calendar.TextCalendar صفحة General calendar-related functions في توثيق بايثون الرسمي.]

[[تصنيف:Python]]
[[تصنيف:Python Modules]]
[[تصنيف:Python Methods]]