CKTIS / JavaScript
Date.parse: text dátumu na časovú pečiatku
Date.parse prevedie text dátumu na milisekundy od epochy alebo vráti NaN, ak text nerozpozná či hodnota leží mimo rozsah.
Verzia: ECMAScript 1 onward; current date-time string rules; example target: Node.js 24.22.2
Syntax
Date.parse(dateString)Date.parse(string) najprv prevedie argument na text a potom vráti časovú hodnotu v milisekundách od epochy. Štandardný formát date-time je podoba ISO 8601, napríklad 2024-02-29T12:30:00+02:00. Samotný dátum ako 2024-02-29 sa chápe ako UTC; dátum s časom bez offsetu sa chápe v miestnom časovom pásme.
Neplatný text alebo hodnota mimo rozsahu TimeClip ±8.64e15 vytvorí NaN, nie výnimku. Prevod argumentu na text však môže vyhodiť, napríklad pri Symbol. Formát z toISOString() musí byť prijatý; pre dátumy s nulovými milisekundami sú vyžadované aj formáty toString() a toUTCString(). Iné formáty závisia od implementácie.
Na výmenu dát používajte úplnú podobu ISO s Z alebo explicitným offsetom, nie nejednoznačný miestny zápis. Date.parse existuje od prvej edície ECMAScript; pravidlá bez offsetu boli neskôr spresnené.
Prí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ýsledok
1709164800000 2024-02-29T00:00:00.000Z 1709202600000 2024-02-29T10:30:00.000Z true