--- title: Date.prototype.toISOString() slug: Web/JavaScript/Reference/Global_Objects/Date/toISOString tags: - Date - JavaScript - Method - Prototype - Reference - polyfill translation_of: Web/JavaScript/Reference/Global_Objects/Date/toISOString ---
{{JSRef("Global_Objects", "Date")}}

Сводка

Метод toISOString() возвращает строку в формате ISO (расширенный формат ISO 8601), который можно описать следующим образом: YYYY-MM-DDTHH:mm:ss.sssZ. Часовой пояс всегда равен UTC, что обозначено суффиксом "Z".

Синтаксис

dateObj.toISOString()

Примеры

Пример: использование метода toISOString()

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

console.log(today.toISOString()); // вернёт 2011-10-05T14:48:00.000Z

Пример выше использует разбор нестандартного строкового значения, которое может разобраться некорректно в браузерах, отличных от Firefox.

Полифил

Этот метод был стандартизирован в ECMA-262 5-го издания. Отсутствие этого метода в движках, которые не были обновлены для его поддержки, можно обойти следующей прокладкой:

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';
    };

  }());
}

Спецификации

Спецификация Статус Комментарии
{{SpecName('ES5.1', '#sec-15.9.5.43', 'Date.prototype.toISOString')}} {{Spec2('ES5.1')}} Изначальное определение. Реализована в JavaScript 1.8.
{{SpecName('ES6', '#sec-date.prototype.toisostring', 'Date.prototype.toISOString')}} {{Spec2('ES6')}}  

Совместимость с браузерами

{{Compat}}

Смотрите также