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

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

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