Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Date.prototype.toISOString: texto UTC canónico

toISOString devolve texto date-time UTC canónico com milissegundos e um Z final.

Versão: ECMAScript 5 (2009) onward; example target: Node.js 24.22.2

Sintaxe

date.toISOString()

date.toISOString() devolve o formato ISO 8601 simplificado em UTC: YYYY-MM-DDTHH:mm:ss.sssZ. Anos normais produzem 24 caracteres; fora de 0000–9999 usa sinal e seis algarismos, produzindo 27. O método não usa o fuso local nem altera o objeto.

Para um Date inválido ou ano não representável no formato exigido, lança RangeError; não devolve "Invalid Date". Um receiver sem estado interno Date lança TypeError. O método não recebe argumentos e os adicionais são ignorados.

O formato serve para intercâmbio de dados e pode ser lido de novo por Date.parse. Não conserva nome de fuso nem offset original, apenas o mesmo instante expresso em UTC. É padrão desde ECMAScript 5 (2009).

Exemplos

const date = new Date(Date.UTC(2024, 1, 29, 12, 34, 56, 789));
console.log(date.toISOString());
console.log(new Date(-1).toISOString());
try { new Date(NaN).toISOString(); } catch (error) { console.log(error instanceof RangeError); }

Resultado

2024-02-29T12:34:56.789Z
1969-12-31T23:59:59.999Z
true

Fontes