الفرق بين المراجعتين ل"JavaScript/Date/setUTCHours"
ط (استبدال النص - '\[\[تصنيف:(.*)\]\]' ب'{{SUBPAGENAME}}') |
|||
| سطر 54: | سطر 54: | ||
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.35 ECMAScript 5.1]. | * معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.5.35 ECMAScript 5.1]. | ||
* معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%201st%20edition,%20June%201997.pdf ECMAScript 1st Edition]. | * معيار [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}}]] |
المراجعة الحالية بتاريخ 15:37، 28 يناير 2018
الدالة 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.