Date.prototype.valueOf()
< JavaScript | Date
الدالة 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.