Date.prototype.setUTCFullYear()‎

الدالة Date.prototype.setUTCFullYear()‎ تضبط السنة (أربعة أرقام) للتاريخ المُحدَّد وفقًا للتوقيت العالمي، تُعيد هذه الدالة بصمة وقت (timestamp).

البنية العامة

dateObj.setUTCFullYear(yearValue[, monthValue[, dayValue]])

yearValue

قيمة عددية صحيحة تُمثِّل السنة، مثلًا 1995.

monthValue

قيمة اختيارية، وهي قيمةٌ عددية صحيحة تُمثِّل الشهر، وتبدأ من 0 (كانون الثاني/يناير) إلى 11 (كانون الأول/ديسمبر).

dayValue

قيمة اختيارية، وهي عددٌ صحيحٌ يُمثِّل اليوم من الشهر بين 1 و 31. إذا حدّدت قيمة المعامل dayValue فيجب أن تُحدِّد قيمة monthValue أيضًا.

القيمة المعادة

كم ملي ثانية قد مضت بدءًا من ‎1 January 1970 00:00:00 UTC للتاريخ المعطى (وستُغيّر قيمة الكائن Date أيضًا).

الوصف

إذا لم تُحدَّد قيمة للمعاملين monthValue و dayValue، فستُستخدَم القيم المُعادة من الدالتين getUTCMonth()‎ و getUTCDate()‎.

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

أمثلة

مثال عن استخدام الدالة setUTCFullYear()‎:

var theBigDay = new Date();
theBigDay.setUTCFullYear(1997);

دعم المتصفحات

الميزة	Chrome	Firefox	Internet Explorer	Opera	Safari
الدعم الأساسي	نعم	نعم	نعم	نعم	نعم

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

• مسودة المعيار ECMAScript Latest Draft.
• معيار ECMAScript 2015 (6th Edition)‎.
• معيار ECMAScript 5.1.
• معيار ECMAScript 1st Edition.