KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Date.parse: datumtekst naar tijdstempel

Date.parse zet datumtekst om in milliseconden sinds de epoch of geeft NaN als de tekst onbekend of buiten bereik is.

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

Syntax

Date.parse(dateString)

Date.parse(string) zet het argument eerst om in tekst en geeft daarna een tijdwaarde in milliseconden sinds de epoch. Het standaard date-time-formaat is een ISO-8601-vorm zoals 2024-02-29T12:30:00+02:00. Alleen een datum zoals 2024-02-29 wordt als UTC geïnterpreteerd; datum en tijd zonder offset worden in de lokale tijdzone geïnterpreteerd.

Ongeldige tekst of een waarde buiten het TimeClip-bereik ±8.64e15 levert NaN op, geen uitzondering. Omzetting van het argument naar tekst kan wel werpen, bijvoorbeeld voor een Symbol. Het formaat van toISOString() moet worden aanvaard; bij datums met nul milliseconden zijn ook de formaten van toString() en toUTCString() vereist. Andere formaten zijn implementatieafhankelijk.

Gebruik voor gegevensuitwisseling de volledige ISO-vorm met Z of expliciete offset in plaats van dubbelzinnige lokale notatie. Date.parse bestaat sinds de eerste ECMAScript-editie; regels zonder offset zijn later verduidelijkt.

Voorbeelden

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

Resultaat

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

Bronnen