JavaScript/Date/toISOString

الدالة 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	نعم	نعم

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

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