Date.prototype.setUTCMonth()
< JavaScript | Date
اذهب إلى التنقل
اذهب إلى البحث
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
الدالة 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.