CKTIS / JavaScript
Date.parse: text data na časové razítko
Date.parse převede text data na milisekundy od epochy nebo vrátí NaN, pokud text nerozpozná či hodnota leží mimo rozsah.
Verze: ECMAScript 1 onward; current date-time string rules; example target: Node.js 24.22.2
Syntaxe
Date.parse(dateString)Date.parse(string) nejprve převede argument na text a pak vrátí časovou hodnotu v milisekundách od epochy. Standardní formát date-time je podoba ISO 8601, například 2024-02-29T12:30:00+02:00. Samotné datum jako 2024-02-29 se chápe jako UTC; datum s časem bez offsetu se chápe v místním časovém pásmu.
Neplatný text nebo hodnota mimo rozsah TimeClip ±8.64e15 vytvoří NaN, nikoli výjimku. Převod argumentu na text však může vyhodit, například u Symbol. Formát z toISOString() musí být přijat; pro data s nulovými milisekundami jsou vyžadovány i formáty toString() a toUTCString(). Jiné formáty závisí na implementaci.
Pro výměnu dat používejte úplnou podobu ISO s Z nebo explicitním offsetem, ne nejednoznačný místní zápis. Date.parse existuje od první edice ECMAScript; pravidla bez offsetu byla později upřesněna.
Příklady
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")));Výsledek
1709164800000 2024-02-29T00:00:00.000Z 1709202600000 2024-02-29T10:30:00.000Z true