KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Date — tijdstempels en het UTC-jaar

Date slaat een tijdstempel op. Leer hoe je het UTC-jaar uitleest en wijzigt, hoe objectmutatie werkt en hoe datums worden genormaliseerd, bijvoorbeeld wanneer 29 februari in een niet-schrikkeljaar valt.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

new Date(milliseconds)
new Date(isoString)
date.getUTCFullYear()
date.setUTCFullYear(year[, month[, day]])

Date is een ingebouwd ECMAScript-object dat milliseconden sinds 1970-01-01T00:00:00.000Z opslaat, of NaN bij een ongeldige datum. Het slaat geen tijdzone op. Lokale methoden interpreteren dezelfde tijdstempel volgens de tijdzone van de omgeving; UTC-methoden gebruiken UTC.

Date.prototype.getUTCFullYear() geeft het volledige UTC-jaar terug, of NaN bij een ongeldige datum. Date.prototype.setUTCFullYear(year[, month[, day]]) wijzigt het object en geeft de resulterende tijdstempel terug, niet een Date-object. Maanden gebruiken de indexen 0–11, terwijl de dagen van de maand bij 1 beginnen. Als de oorspronkelijke datum geldig is, gebruikt de methode voor elk weggelaten maand- of dagargument de oorspronkelijke UTC-waarde als invoer. Door normalisatie kunnen de maand en de dag in het resultaat veranderen. Als het resultaat geldig is, blijft de tijd van de dag in UTC ongewijzigd.

De setter normaliseert waarden: het wijzigen van 29 februari naar een niet-schrikkeljaar levert 1 maart op. Een jaar van 0–99 wordt letterlijk geïnterpreteerd, anders dan bij de Date-constructor met meerdere argumenten. Bij een ongeldige datum gebruikt de setter tijdstempel 0 als uitgangspunt; ongeldige numerieke argumenten kunnen nog steeds NaN opleveren.

Het voorbeeld gebruikt een expliciete Z en UTC-methoden, zodat het resultaat niet afhankelijk is van de lokale tijdzone. Het controleert ook of de geretourneerde tijdstempel overeenkomt met het gewijzigde object.

Voorbeelden

const date = new Date("2024-02-29T12:00:00.000Z");
console.log(date.getUTCFullYear());
const timestamp = date.setUTCFullYear(2025);
console.log(date.toISOString());
console.log(timestamp === date.getTime());

Resultaat

2024
2025-03-01T12:00:00.000Z
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen