عرض مصدر Python/HTMLCalendar/formatmonth

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

يعيد التابع تقويم الشهر المعطى بصيغة جدول HTML.

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

<syntaxhighlight lang="python3">
‎formatmonth(theyear, themonth, withyear=True)
</syntaxhighlight>

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

===<code>theyear</code>===
السنة المطلوبة.
===<code>themonth</code>===
الشهر المطلوب (من 1 إلى 12). 
===<code>withyear</code>===
معامل اختياري يحمل قيمة منطقية. إن أخذ هذا المعامل القيمة True فإنّ التابع سيضيف السنة إلى ترويسة جدول HTML المعاد. أما إن أخذ االمعامل القيمة False فتقتصر الترويسة على اسم الشهر فقط.

== القيمة المعادة ==
سلسلة نصية تتضمّن تقويم الشهر المطلوب في السنة المطلوبة بهيئة جدول HTML.
== أمثلة ==

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

<syntaxhighlight lang="python3">
>>> from calendar import HTMLCalendar
>>> cal = HTMLCalendar()
>>> cal.formatmonth(2018, 8)
'<table border="0" cellpadding="0" cellspacing="0" class="month">\n<tr><th colspan="7" class="month">August 2018</th></tr>\n<tr><th class="mon">Mon</th><th class="tue">Tue</th><th class="wed">Wed</th><th class="thu">Thu</th><th class="fri">Fri</th><th class="sat">Sat</th><th class="sun">Sun</th></tr>\n<tr><td class="noday">&nbsp;</td><td class="noday">&nbsp;</td><td class="wed">1</td><td class="thu">2</td><td class="fri">3</td><td class="sat">4</td><td class="sun">5</td></tr>\n<tr><td class="mon">6</td><td class="tue">7</td><td class="wed">8</td><td class="thu">9</td><td class="fri">10</td><td class="sat">11</td><td class="sun">12</td></tr>\n<tr><td class="mon">13</td><td class="tue">14</td><td class="wed">15</td><td class="thu">16</td><td class="fri">17</td><td class="sat">18</td><td class="sun">19</td></tr>\n<tr><td class="mon">20</td><td class="tue">21</td><td class="wed">22</td><td class="thu">23</td><td class="fri">24</td><td class="sat">25</td><td class="sun">26</td></tr>\n<tr><td class="mon">27</td><td class="tue">28</td><td class="wed">29</td><td class="thu">30</td><td class="fri">31</td><td class="noday">&nbsp;</td><td class="noday">&nbsp;</td></tr>\n</table>\n'

</syntaxhighlight>

== انظر أيضًا ==

* التابع [[Python/HTMLCalendar/formatyear|<code>formatyear</code>()‎]]: يعيد التابع تقويم السنة المعطاة على هيئة جدول HTML.
* التابع [[Python/HTMLCalendar/formatyearpage|<code>formatyearpage</code>()‎]]: يعيد التابع تقويم السنة المعطاة على هيئة صفحة HTML كاملة.

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


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