Date.prototype.valueOf()‎

الدالة Number.prototype.valueOf()‎ تُعيد القيمة الأوليّة (primitive value) لأحد كائنات Date.

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

dateObj.valueOf()

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

كم ملي ثانية قد مضت بدءًا من ‎1 January 1970 00:00:00 UTC للتاريخ المعطى.

الوصف

تستدعي JavaScript الدالة valueOf لتحويل كائن Date إلى قيمة أوليّة، ومن النادر أن تحتاج إلى استدعاء الدالة valueOf يدويًا، إذ تستدعيها JavaScript تلقائيًا عند الحاجة.

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

أمثلة

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

var x = new Date(56, 6, 17);
var myVar = x.valueOf();      // إسناد القيمة -424713600000 إلى المتغير

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

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

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

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