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

CKTIS / JavaScript

Date.parse: texto de data para marca temporal

Date.parse converte texto de data em milissegundos desde a época ou devolve NaN quando o texto não é reconhecido ou está fora do intervalo.

Versão: ECMAScript 1 onward; current date-time string rules; example target: Node.js 24.22.2

Sintaxe

Date.parse(dateString)

Date.parse(string) converte primeiro o argumento em texto e depois devolve um valor temporal em milissegundos desde a época. O formato date-time padrão é uma forma ISO 8601 como 2024-02-29T12:30:00+02:00. Uma data isolada como 2024-02-29 é interpretada em UTC; data e hora sem offset são interpretadas no fuso local.

Texto inválido ou valor fora do intervalo TimeClip ±8.64e15 produz NaN, não uma exceção. A conversão do argumento para texto ainda pode lançar, por exemplo com um Symbol. O formato de toISOString() tem de ser aceite; para datas com zero milissegundos também são exigidos os formatos de toString() e toUTCString(). Outros formatos dependem da implementação.

Para intercâmbio de dados usa a forma ISO completa com Z ou offset explícito, não uma notação local ambígua. Date.parse existe desde a primeira edição ECMAScript; as regras sem offset foram clarificadas depois.

Exemplos

const dateOnly = Date.parse("2024-02-29");
const withOffset = Date.parse("2024-02-29T12:30:00+02:00");

console.log(dateOnly, new Date(dateOnly).toISOString());
console.log(withOffset, new Date(withOffset).toISOString());
console.log(Number.isNaN(Date.parse("not a date")));

Resultado

1709164800000 2024-02-29T00:00:00.000Z
1709202600000 2024-02-29T10:30:00.000Z
true

Fontes