Date.prototype.toDateString()‎

الدالة Date.prototype.toDateString()‎ تعيد قسم التاريخ من كائن Date كسلسلة نصية سهلة القراءة من البشر.

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

dateObj.toDateString()

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

سلسلة نصية تُمثِّل قسم التاريخ من كائن Date.

الوصف

كائنات Date تُشير إلى لحظة زمنية معيّنة، واستدعاء الدالة toString()‎ سيُعيد التاريخ كسلسلة نصية سهلة القراءة من البشر، وهو يتألف من قسم التاريخ (اليوم والشهر والسنة) متبوعًا بقسم الوقت (الساعات والدقائق والثواني والمنطقة الزمنية)؛ لكن في بعض الأحيان من الأفضل الحصول على قسم التاريخ فقط دونًا عن الوقت، وذلك باستخدام الدالة toDateString()‎.

الدالة toDateString()‎ مفيدة لأنَّ محركات JavaScript التي تُطبِّق مواصفة ECMAScript قد تختلف فيما بينها بالسلسلة النصية المُعادة من الدالة toString()‎، لأنَّ الصيغة تختلف بين المتصفحات ولا يمكن استخدام طرائق تقسيم السلاسل النصية البسيطة لأنها قد تعطي نتائج غير متوقعة.

أمثلة

مثال بسيط عن استخدام الدالة toDateString()‎:

var d = new Date(1993, 5, 28, 14, 39, 7);

console.log(d.toString());     // Wed Jun 28 1993 14:39:07 GMT-0600 (PDT)
console.log(d.toDateString()); // Wed Jun 28 1993

تذكر أنَّ ترقيم الأشهر يبدأ من الصفر في كائنات Date.

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

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

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

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