Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje