الفرق بين المراجعتين لصفحة: «JavaScript/Date/setUTCMonth»

المراجعة الحالية بتاريخ 15:42، 28 يناير 2018

الدالة 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.

@@ سطر 46: / سطر 46: @@
 * معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.39 ECMAScript 5.1].
 * معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%201st%20edition,%20June%201997.pdf ECMAScript 1st Edition].
-[[تصنيف:JavaScript]]
+[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
-[[تصنيف:JavaScript Global Objects]]
+[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
-[[تصنيف:JavaScript Date]]
+[[تصنيف:JavaScript Date|{{SUBPAGENAME}}]]