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