Date.prototype.setUTCSeconds()‎

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

الدالة 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
الدعم الأساسي نعم نعم نعم نعم نعم

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