عرض مصدر Python/calendar/monthcalendar

<noinclude>{{DISPLAYTITLE:الدالة <code>calendar.monthcalendar()‎</code> في بايثون}}</noinclude>
تعيد الدالة مصفوفة matrix تمثّل تقويم الشهر.

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

<syntaxhighlight lang="python3">
calendar.monthcalendar(year, month)
</syntaxhighlight>

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

=== <code>year</code> ===
السنة المطلوبة.
=== <code>month</code> ===
الشهر المطلوب (من 1 إلى 12).

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

تعيد الدالة قائمة تتضمّن مصفوفة matrix تمثّل تقويم الشهر، ويعبّر كل صفّ row في هذه المصفوفة عن أسبوع واحد، أما الأيام التي تكون خارج نطاق الشهر المحدّد فتأخذ القيمة <code>0</code>. يبدأ كل أسبوع بيوم الإثنين ما لم تحدّد بداية الأسبوع بواسطة الدالة [[Python/calendar/setfirstweekday|<code>setfirstweekday()</code>]]‎.

== أمثلة ==

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

<syntaxhighlight lang="python3">
>>> import calendar
>>> calendar.monthcalendar(2018, 8)
[[0, 1, 2, 3, 4, 5, 6], [7, 8, 9, 10, 11, 12, 13], [14, 15, 16, 17, 18, 19, 20], [21, 22, 23, 24, 25, 26, 27], [28, 29, 30, 31, 0, 0, 0]]

</syntaxhighlight>

== انظر أيضًا ==
الدالة [[Python/calendar/monthrange|<code>monthrange()‎</code>]]: تعيد الدالة أول يوم في الشهر وعدد أيام الشهر المعطى في السنة المعطاة.

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

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