--- title: Date.prototype.toISOString() slug: Web/JavaScript/Reference/Global_Objects/Date/toISOString tags: - Date - JavaScript - Method - Prototipo - Prototype - Referencia - data - metodo - polyfill translation_of: Web/JavaScript/Reference/Global_Objects/Date/toISOString ---
{{JSRef}}

O método toISOString() retorna uma cadeia de caracteres (string) simplificada no formato ISO extendido (ISO 8601), que é sempre 24 ou 27 caracteres de tamanho (YYYY-MM-DDTHH:mm:ss.sssZ ou ±YYYYYY-MM-DDTHH:mm:ss.sssZ, respectivamente). O fuso horário é sempre o deslocamente zero UTC, como denotado pelo sufixo "Z".

{{EmbedInteractiveExample("pages/js/date-toisostring.html")}}

Sintaxe

dateObj.toISOString()

Valor de retorno

Uma string representando a data no formato ISO 8601 de acordo com o horário universal.

Polyfill

Este método foi padronizado na quinta edição da ECMA-262. Motores que não foram atualizados para suportar este método podem funcionar com uma gambiarra na ausência deste método da seguinte forma:

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

  })();
}

Exemplos

Usando toISOString()

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

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

O exemplo acima usa uma conversão de uma string não-padrão que pode não ser convertida corretamente em navegadores que não sejam da Mozilla..

Especificações

Especificação
{{SpecName('ESDraft', '#sec-date.prototype.toisostring', 'Date.prototype.toISOString')}}

Compatibilidade de navegador

{{Compat("javascript.builtins.Date.toISOString")}}

Veja também