Date.prototype.toISOString()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.
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 deslocamento zero UTC, como denotado pelo sufixo "Z".
Experimente
const event = new Date("05 October 2011 14:48 UTC");
console.log(event.toString());
// Expected output: "Wed Oct 05 2011 16:48:00 GMT+0200 (CEST)"
// Note: your timezone may vary
console.log(event.toISOString());
// Expected output: "2011-10-05T14:48:00.000Z"
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()); // Retorna 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
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.toisostring |
Compatibilidade com navegadores
Loading…