Date.prototype.toISOString()‎

من موسوعة حسوب
مراجعة 08:24، 10 ديسمبر 2017 بواسطة عبد اللطيف ايمش (نقاش | مساهمات)
(فرق) → مراجعة أقدم | المراجعة الحالية (فرق) | مراجعة أحدث ← (فرق)

الدالة Date.prototype.toISOString()‎ تعيد سلسلة نصية بصيغة ISO الموسعة المبسّطة (ISO 8601) وهي تكون دومًا بطول 24 أو 27 محرفًا (YYYY-MM-DDTHH:mm:ss.sssZ أو ‎±YYYYYY-MM-DDTHH:mm:ss.sssZ). وتكون المنطقة الزمنية هي UTC، كما هو واضح من اللاحقة Z.

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

dateObj.toISOString()

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

سلسلة نصية تُمثِّل التاريخ بصيغة ISO 8601 وفقًا للتوقيت العالمي.

أمثلة

مثال استخدام الدالة toISOString()‎:

var today = new Date('05 October 2011 14:48 UTC');

console.log(today.toISOString()); // 2011-10-05T14:48:00.000Z

لاحظ أنَّ المثال السابق يفسّر سلسلة نصية غير معيارية ليحوّلها إلى تاريخ، وقد لا يعمل كما ينبغي في جميع المتصفحات.

تعويض نقص دعم المتصفحات

هذه الدالة أصبحت معياريةً في إصدار ECMAScript 5.1، لكن يمكن إضافة هذه الدالة في المتصفحات غير الداعمة لها باستخدام الشيفرة الآتية:

if (!Date.prototype.toISOString) {
  (function() {

    function pad(number) {
      if (number < 10) {
        return '0' + number;
      }
      return number;
    }

    Date.prototype.toISOString = function() {
      return this.getUTCFullYear() +
        '-' + pad(this.getUTCMonth() + 1) +
        '-' + pad(this.getUTCDate()) +
        'T' + pad(this.getUTCHours()) +
        ':' + pad(this.getUTCMinutes()) +
        ':' + pad(this.getUTCSeconds()) +
        '.' + (this.getUTCMilliseconds() / 1000).toFixed(3).slice(2, 5) +
        'Z';
    };

  }());
}

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

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

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