Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Date.parse: testo della data in timestamp

Date.parse converte il testo di una data in millisecondi dall’epoca o restituisce NaN se il testo non è riconosciuto o è fuori intervallo.

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

Sintassi

Date.parse(dateString)

Date.parse(string) converte prima l’argomento in testo, poi restituisce un valore temporale in millisecondi dall’epoca. Il formato date-time standard è una forma ISO 8601 come 2024-02-29T12:30:00+02:00. Una sola data come 2024-02-29 è interpretata come UTC; data e ora senza offset sono interpretate nel fuso locale.

Testo non valido o valore fuori dall’intervallo TimeClip ±8.64e15 produce NaN, non un’eccezione. La conversione dell’argomento in testo può però generare, per esempio con un Symbol. Il formato di toISOString() deve essere accettato; per date con millisecondi zero sono richiesti anche i formati di toString() e toUTCString(). Gli altri formati dipendono dall’implementazione.

Per scambiare dati usa la forma ISO completa con Z o offset esplicito, non una notazione locale ambigua. Date.parse esiste dalla prima edizione ECMAScript; le regole senza offset sono state chiarite in seguito.

Esempi

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")));

Risultato

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

Fonti