Date.prototype.toISOString()

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

Синтаксис

dateObj.toISOString()

Повертає

Рядкове представлення наданої дати у форматі ISO 8601 згідно зі всесвітнім часом.

Поліфіл

Цей метод був стандартизований у 5-й версії ECMA-262. Рушії, що не були оновлені, щоб підтримувати цей метод, можуть обійти його відсутність за допомогою наступного шиму:

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

  })();
}

Приклади

Використання toISOString()

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

console.log(today.toISOString())  // Повертає 2011-10-05T14:48:00.000Z

Наведений вище приклад використовує розбір нестандартного рядкового значення, яке, можливо, не буде коректно розібране у не Mozilla-переглядачах.

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

Специфікація
ECMAScript (ECMA-262)
The definition of 'Date.prototype.toISOString' in that specification.

Сумісність з веб-переглядачами

BCD tables only load in the browser

Див. також