KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Het UTC-jaar van een Date-object lezen en wijzigen

`getUTCFullYear()` leest het jaar in UTC. `setUTCFullYear()` wijzigt hetzelfde `Date`-object en geeft de nieuwe tijdstempel terug. Een argument weglaten is niet hetzelfde als `undefined` doorgeven.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

date.getUTCFullYear()
date.setUTCFullYear(year)
date.setUTCFullYear(year, monthIndex)
date.setUTCFullYear(year, monthIndex, dayOfMonth)

getUTCFullYear() neemt geen argumenten aan en geeft het kalenderjaar in UTC terug als een geheel getal, niet als een tekenreeks van vier cijfers. Bij een ongeldige datum geeft de methode NaN terug. getFullYear() en setFullYear() gebruiken daarentegen de lokale tijdzone van de uitvoeringsomgeving. Rond de jaarwisseling kan hetzelfde tijdstip in UTC en in lokale tijd in verschillende jaren vallen.

setUTCFullYear(year, monthIndex, dayOfMonth) wijzigt het bestaande Date-object en geeft de nieuwe tijdstempel terug in milliseconden sinds de Unix-epoch. Het jaar is verplicht. De optionele maandindex loopt van 0 (januari) tot 11 (december) en de dag van de maand begint bij 1. Om een dag op te geven moet je ook een maand opgeven. Weggelaten onderdelen en de tijd van de dag komen uit de bestaande UTC-datum. Waarden buiten het gebruikelijke kalenderbereik worden genormaliseerd: 29 februari wordt 1 maart als je naar een niet-schrikkeljaar overschakelt.

Argumenten worden omgezet in getallen. Expliciet undefined doorgeven is niet hetzelfde als weglaten: het wordt NaN. Als een argument NaN wordt of de resulterende tijdstempel buiten het bereik van Date valt, slaat de methode NaN op en geeft die waarde terug. Was de datum al ongeldig, dan neemt de methode 1970-01-01T00:00:00.000Z als uitgangspunt. Een geldige aanroep kan de datum dus herstellen.

Anders dan Date.UTC() telt setUTCFullYear() geen 1900 op bij jaren van 0 tot en met 99. Beide prototypemethoden vereisen een echt Date-object als this. Een aanroep met een ongeschikte this werpt een TypeError.

Voorbeelden

const date = new Date('2024-02-29T12:34:56.789Z');
console.log(date.getUTCFullYear());
console.log(date.setUTCFullYear(2023));
console.log(date.toISOString());
console.log(date.setUTCFullYear(2023, undefined));
console.log(date.getUTCFullYear());
date.setUTCFullYear(7);
console.log(date.toISOString());

Resultaat

2024
1677674096789
2023-03-01T12:34:56.789Z
NaN
NaN
0007-01-01T00:00:00.000Z

Bij de wijziging naar 2023 schuift 29 februari door naar 1 maart zonder de UTC-tijd van de dag te veranderen. Expliciet `undefined` maakt de datum ongeldig. Het jaar instellen op `7` herstelt de datum naar 1 januari van het jaar 7 om middernacht UTC.

Gerelateerde lessen

  • JavaScript · Les 5 · Gevorderd · Versie: 4

Bronnen