KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Date.prototype.setTime: tijdwaarde vervangen

setTime vervangt de tijdwaarde van een Date-object door epochmilliseconden, past TimeClip toe en geeft de nieuwe waarde.

Versie: ECMAScript 1 onward; example target: Node.js 24.22.2

Syntax

date.setTime(timeValue)

date.setTime(timeValue) zet het argument met ToNumber om, kapt een breuk naar nul af en bewaart milliseconden sinds 1970-01-01T00:00:00Z. De bewerking hangt niet af van lokale tijdzone of vorige velden. Ze geeft de bewaarde waarde, die daarna gelijk is aan getTime().

Een niet-eindige waarde, NaN, ontbrekend argument of absolute waarde boven 8.64e15 maakt de datum ongeldig en geeft NaN. Een latere geldige aanroep kan een ongeldige Date herstellen. BigInt en Symbol werpen TypeError tijdens ToNumber; objectcoërcie kan ook werpen.

Een receiver zonder interne Date-status werpt TypeError; extra argumenten worden genegeerd. Gebruik setTime om een tijdstempel te herstellen of een tijdstip in milliseconden te verschuiven. De methode bestaat sinds ECMAScript 1.

Voorbeelden

const date = new Date(0);
console.log(date.setTime(1704067200123.9));
console.log(date.toISOString());

console.log(date.setTime(8.64e15 + 1), Number.isNaN(date.getTime()));
console.log(date.setTime(0), date.toISOString());

Resultaat

1704067200123
2024-01-01T00:00:00.123Z
NaN true
0 1970-01-01T00:00:00.000Z

Bronnen