`Date.prototype.setSeconds()‎`

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

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

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

dateObj.setSeconds(secondsValue[, msValue])

في الإصدارات التي تسبق JavaScript 1.3:

dateObj.setSeconds(secondsValue)

`secondsValue`

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

`msValue`

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

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

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

الوصف

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

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

أمثلة

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

var theBigDay = new Date();
theBigDay.setSeconds(30);

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

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

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

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