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.

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

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
toISOStringChrome Full support 3Edge Full support 12Firefox Full support 1IE Full support 9Opera Full support 10.5Safari Full support 5WebView Android Full support ≤37Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support 11Safari iOS Full support 4.2Samsung Internet Android Full support 1.0nodejs Full support 0.1.100

Legend

Full support  
Full support

Див. також