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

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

الدالة Date.prototype.setUTCSeconds()‎ تضبط الثواني للتاريخ المُحدَّد وفقًا للتوقيت العالمي.

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

dateObj.setUTCSeconds(secondsValue[, msValue])

`secondsValue`

عددٌ صحيحٌ يُمثِّل عدد الثواني من الوقت بين 0 و 59.

`msValue`

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

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

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

الوصف

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

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

أمثلة

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

var theBigDay = new Date();
theBigDay.setUTCSeconds(20);

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

الميزة	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.31 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}}]]