عرض مصدر JavaScript/Date/setMonth

<noinclude>{{DISPLAYTITLE:<code>Date.prototype.setMonth()‎</code>}}</noinclude>
الدالة <code>Date.prototype.setMonth()‎</code> تعيد الشهر للتاريخ المُحدَّد وفقًا للتوقيت المحلي؛ نذكِّر أنَّ العد يبدأ من 0 (أي أوّل شهر في السنة رقمه 0).

== البنية العامة ==
<syntaxhighlight lang="javascript">
dateObj.setMonth(monthValue[, dayValue])

</syntaxhighlight>في الإصدارات التي تسبق JavaScript 1.3:<syntaxhighlight lang="javascript">
dateObj.setMonth(monthValue)

</syntaxhighlight>

=== <code>monthValue</code> ===
عدد صحيح بين 0 و 11، يُمثِّل الأشطر من كانون الثاني/يناير إلى كانون الأول/ديسمبر.

=== <code>dayValue</code> ===
وسيطٌ اختياري، وهو عددٌ صحيحٌ من 1 إلى 31، يُمثِّل اليوم في الشهر.

=== القيمة المعادة ===
كم ملي ثانية قد مضت بدءًا من ‎1 January 1970 00:00:00 UTC للتاريخ المعطى (وستُغيّر قيمة الكائن <code>[[JavaScript/Date|Date]]</code> أيضًا).
==الوصف==
إذا لم تُحدَّد قيمة للمعامل  <code>dayValue</code>، فستُستخدَم القيم المُعادة من الدالة <code>[[JavaScript/Date/getDate|getDate()‎]]</code>.

إذا كانت قيمة الوسيط خارج المجال المسموح، فستُحدِّث الدالة <code>setMonth</code> الكائن <code>Date</code> بما يتوافق مع ذلك، أو لو ضبطنا قيمة الوسيط <code>monthValue</code> إلى <code>15</code>، فستزداد السنة بمقدار <code>1</code> (أي <code>yearValue + 1</code>) وستُستخدَم القيمة <code>3</code> للشهر.

اليوم الحالي من الشهر له تأثيرٌ على سلوك هذه الدالة، إذ سيُضاف عدد الأيام المضبوطة في كائن <code>[[JavaScript/Date|Date]]</code> إلى الأول من الشهر الجديد المُحدَّد عبر هذه الدالة، وسيُعاد التاريخ الجديد. فمثلًا، إذا كان التاريخ الحالي هو 31 من آب/أغسطس 2016، واستدعينا الدالة <code>setMonth</code> مع القيمة 1، فالتاريخ المُعاد هو اليوم الثاني من آذار/مارس 2016، ذلك لأنَّ شهر شباط/فبراير في عام 2016 له 29 يومًا.
== أمثلة ==
مثال عن استخدام الدالة <code>setMonth()‎</code>:<syntaxhighlight lang="javascript">
var theBigDay = new Date();
theBigDay.setMonth(6);
</syntaxhighlight>خذ حذرك عند ضبط الشهر دون اليوم، فقد تحصل على سلوكٍ غير متوقع:<syntaxhighlight lang="javascript">
var endOfMonth = new Date(2016, 7, 31);
endOfMonth.setMonth(1);
console.log(endOfMonth); // Wed Mar 02 2016 00:00:00
</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|نعم
|نعم
|نعم
|}
== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-date.prototype.setmonth ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-date.prototype.setmonth ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.38 ECMAScript 5.1].
* معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%201st%20edition,%20June%201997.pdf ECMAScript 1st Edition]. 
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Date|{{SUBPAGENAME}}]]