Date.prototype.setUTCSeconds()

Funktionsweise

Werte außerhalb von 0–59 führen zu einem Minutenüberlauf in UTC. Da Sekunden zeitzonen-unabhängig sind, ist das Verhalten in der Praxis identisch zu setSeconds().

Die Methode mutiert die Date-Instanz und gibt zusätzlich den neuen Zeitstempel zurück. Sie wird typischerweise in Kombination mit setUTCHours() und setUTCMinutes() verwendet, um eine vollständige UTC-Zeit zu setzen.

Syntax

date.setUTCSeconds(secondsValue)
date.setUTCSeconds(secondsValue, msValue)

Rückgabewert

Die Anzahl der Millisekunden seit dem 1. Januar 1970 UTC nach der Aktualisierung.

Beispiele

UTC-Sekunden setzen

const date = new Date("2026-05-01T10:00:00Z");
date.setUTCSeconds(45);
console.log(date.toISOString());

2026-05-01T10:00:45.000Z

Minutenüberlauf in UTC

const date = new Date("2026-05-01T10:00:00Z");
date.setUTCSeconds(125);
console.log(date.toISOString());

2026-05-01T10:02:05.000Z

Sekunden und Millisekunden zusammen setzen

const date = new Date("2026-05-01T10:00:00Z");
date.setUTCSeconds(30, 500);
console.log(date.toISOString());

2026-05-01T10:00:30.500Z

Sekunden auf 0 zurücksetzen

function rundeAufMinuteUTC(date) {
    const result = new Date(date);
    result.setUTCSeconds(0, 0);
    return result;
}

const date = new Date("2026-05-01T10:00:42.873Z");
console.log(rundeAufMinuteUTC(date).toISOString());

2026-05-01T10:00:00.000Z

Hinweise & verwandte Methoden

• Für die lokale Variante: Date.prototype.setSeconds() – verhält sich praktisch identisch.
• Für „in N Sekunden in UTC”: setUTCSeconds(getUTCSeconds() + N).
• Beim Setzen auf eine volle Minute sollte gleichzeitig msValue auf 0 gesetzt werden, um saubere Zeitstempel zu erhalten.
• Die Methode mutiert das Original.