Date.prototype.setUTCMonth()‎

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

الدالة 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
الدعم الأساسي نعم نعم نعم نعم نعم

مصادر ومواصفات