Date.prototype.setMinutes()
الدالة Date.prototype.setMinutes()
تضبط الدقائق (0-59) للتاريخ المُحدَّد وفقًا للتوقيت المحلي.
البنية العامة
dateObj.setMinutes(minutesValue[, secondsValue[, msValue]])
في الإصدارات التي تسبق JavaScript 1.3:
dateObj.setMinutes(minutesValue)
minutesValue
عددٌ صحيحٌ يُمثِّل عدد الدقائق من الوقت بين 0 و 59.
secondsValue
قيمةٌ اختياريةٌ، وهي عددٌ صحيحٌ يُمثِّل عدد الثواني من الوقت بين 0 و 59.
msValue
قيمةٌ اختياريةٌ، وهي عددٌ صحيحٌ يُمثِّل عدد الملي ثانية من الوقت بين 0 و 999. إذا حدّدت قيمةً للمعامل msValue
فيجب أن تضبط قيمة secondsValue
أيضًا.
القيمة المعادة
كم ملي ثانية قد مضت بدءًا من 1 January 1970 00:00:00 UTC للتاريخ المعطى (وستُغيّر قيمة الكائن Date
أيضًا).
الوصف
إذا لم تُحدَّد قيمة للمعاملين secondsValue
و msValue
، فستُستخدَم القيم المُعادة من الدالتين getSeconds()
و getMilliseconds()
.
إذا كانت قيمة الوسيط خارج المجال المسموح، فستُحدِّث الدالة setMinutes
الكائن Date
بما يتوافق مع ذلك، أو لو ضبطنا قيمة الوسيط secondsValue
إلى 100
، فستزداد الدقائق بمقدار 1 (أي minutesValue + 1
)، وستُستخدَم القيمة 40
للثواني.
أمثلة
مثال عن استخدام الدالة setMinutes()
:
var theBigDay = new Date();
theBigDay.setMinutes(45);
دعم المتصفحات
الميزة | Chrome | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
الدعم الأساسي | نعم | نعم | نعم | نعم | نعم |
مصادر ومواصفات
- مسودة المعيار ECMAScript Latest Draft.
- معيار ECMAScript 2015 (6th Edition).
- معيار ECMAScript 5.1.
- معيار ECMAScript 1st Edition.