`Date.prototype.setUTCHours()‎`

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

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

dateObj.setUTCHours(hoursValue[, minutesValue[, secondsValue[, msValue]]])

`hoursValue`

عددٌ صحيحٌ يُمثِّل الساعة من اليوم بين 0 و 23.

`minutesValue`

قيمةٌ اختياريةٌ، وهي عددٌ صحيحٌ يُمثِّل عدد الدقائق من الوقت بين 0 و 59.

`secondsValue`

قيمةٌ اختياريةٌ، وهي عددٌ صحيحٌ يُمثِّل عدد الثواني من الوقت بين 0 و 59. إذا حدّدت قيمةً للمعامل secondsValue فيجب أن تضبط قيمة minutesValue أيضًا.

`msValue`

قيمةٌ اختياريةٌ، وهي عددٌ صحيحٌ يُمثِّل عدد الملي ثانية من الوقت بين 0 و 999. إذا حدّدت قيمةً للمعامل msValue فيجب أن تضبط قيمة minutesValue و secondsValue أيضًا.

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

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

الوصف

إذا لم تُحدَّد قيمة للمعاملات minutesValue و secondsValue و msValue، فستُستخدَم القيم المُعادة من الدوال getUTCMinutes()‎ و getUTCSeconds()‎ و getUTCMilliseconds()‎.

إذا كانت قيمة الوسيط خارج المجال المسموح، فستُحدِّث الدالة setUTCHours الكائن Date بما يتوافق مع ذلك، أو لو ضبطنا قيمة الوسيط secondsValue إلى 100، فستزداد الدقائق بمقدار 1 (أي minutesValue + 1)، وستُستخدَم القيمة 40 للثواني.

أمثلة

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

var theBigDay = new Date();
theBigDay.setUTCHours(8);

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

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

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

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