WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Date.prototype.setTime: Zeitwert ersetzen

setTime ersetzt den Zeitwert eines Date-Objekts durch Epochenmillisekunden, wendet TimeClip an und liefert den neuen Wert.

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

Syntax

date.setTime(timeValue)

date.setTime(timeValue) konvertiert das Argument mit ToNumber, schneidet einen Bruch gegen null ab und speichert Millisekunden seit 1970-01-01T00:00:00Z. Die Operation hängt weder von lokaler Zeitzone noch bisherigen Kalenderfeldern ab. Sie liefert den gespeicherten Wert, der danach getTime() entspricht.

Ein nicht endlicher Wert, NaN, ein fehlendes Argument oder ein Betrag über 8.64e15 macht das Datum ungültig und liefert NaN. Ein späterer gültiger Aufruf kann ein ungültiges Date wiederherstellen. BigInt und Symbol lösen bei ToNumber TypeError aus; auch Objektkonvertierung kann werfen.

Ein Receiver ohne internen Date-Zustand führt zu TypeError; zusätzliche Argumente werden ignoriert. Nutze setTime zum Wiederherstellen eines Zeitstempels oder Verschieben um Millisekunden. Die Methode existiert seit ECMAScript 1.

Beispiele

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

Ergebnis

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

Quellen