Date.prototype.setMinutes()‎

من موسوعة حسوب
< JavaScript‏ | Date
مراجعة 14:56، 9 ديسمبر 2017 بواسطة عبد اللطيف ايمش (نقاش | مساهمات)
(فرق) → مراجعة أقدم | المراجعة الحالية (فرق) | مراجعة أحدث ← (فرق)
اذهب إلى التنقل اذهب إلى البحث

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

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