Date.prototype.setUTCSeconds()
< JavaScript | Date
الدالة 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.