Date.prototype.toTimeString()‎

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

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

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

dateObj.toTimeString()

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

سلسلة نصية تُمثِّل قسم الوقت من كائن Date بصيغة American English.

الوصف

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

الدالة toTimeString()‎ مفيدة لأنَّ محركات 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.toTimeString()); // 14:39:07 GMT-0600 (PDT)
تذكر أنَّ ترقيم الأشهر يبدأ من الصفر في كائنات Date.

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

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

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