Date.prototype.setUTCMonth()
< JavaScript | Date
الدالة Date.prototype.setUTCMonth() تعيد الشهر للتاريخ المُحدَّد وفقًا للتوقيت العالمي؛ نذكِّر أنَّ العد يبدأ من 0 (أي أوّل شهر في السنة رقمه 0).
البنية العامة
dateObj.setUTCMonth(monthValue[, dayValue])
monthValue
عدد صحيح بين 0 و 11، يُمثِّل الأشطر من كانون الثاني/يناير إلى كانون الأول/ديسمبر.
dayValue
وسيطٌ اختياري، وهو عددٌ صحيحٌ من 1 إلى 31، يُمثِّل اليوم في الشهر.
القيمة المعادة
كم ملي ثانية قد مضت بدءًا من 1 January 1970 00:00:00 UTC للتاريخ المعطى (وستُغيّر قيمة الكائن Date أيضًا).
الوصف
إذا لم تُحدَّد قيمة للمعامل dayValue، فستُستخدَم القيم المُعادة من الدالة getUTCDate().
إذا كانت قيمة الوسيط خارج المجال المسموح، فستُحدِّث الدالة setUTCMonth الكائن Date بما يتوافق مع ذلك، أو لو ضبطنا قيمة الوسيط monthValue إلى 15، فستزداد السنة بمقدار 1 (أي yearValue + 1) وستُستخدَم القيمة 3 للشهر.
أمثلة
مثال عن استخدام الدالة setUTCMonth():
var theBigDay = new Date();
theBigDay.setUTCMonth(11);
دعم المتصفحات
| الميزة | Chrome | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| الدعم الأساسي | نعم | نعم | نعم | نعم | نعم |
مصادر ومواصفات
- مسودة المعيار ECMAScript Latest Draft.
- معيار ECMAScript 2015 (6th Edition).
- معيار ECMAScript 5.1.
- معيار ECMAScript 1st Edition.