Date.prototype.setSeconds()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Die setSeconds() Methode von Date Instanzen ändert die Sekunden und/oder Millisekunden für dieses Datum gemäß der lokalen Zeit.
Probieren Sie es aus
const event = new Date("August 19, 1975 23:15:30");
event.setSeconds(42);
console.log(event.getSeconds());
// Expected output: 42
console.log(event);
// Expected output: "Sat Apr 19 1975 23:15:42 GMT+0100 (CET)"
// Note: your timezone may vary
Syntax
setSeconds(secondsValue)
setSeconds(secondsValue, msValue)
Parameter
secondsValue-
Ein ganzzahliger Wert zwischen 0 und 59, der die Sekunden darstellt.
msValueOptional-
Ein ganzzahliger Wert zwischen 0 und 999, der die Millisekunden darstellt.
Rückgabewert
Ändert das Date Objekt vor Ort und gibt dessen neuen Zeitstempel zurück. Wenn ein Parameter NaN ist (oder andere Werte, die zu NaN gezwungen werden, wie undefined), wird das Datum auf Invalid Date gesetzt und NaN zurückgegeben.
Beschreibung
Wenn Sie den msValue Parameter nicht angeben, wird der Wert von der getMilliseconds() Methode verwendet.
Wenn ein von Ihnen angegebener Parameter außerhalb des erwarteten Bereichs liegt, versucht setSeconds(), die Datumsinformationen im Date Objekt entsprechend zu aktualisieren. Zum Beispiel, wenn Sie 100 für secondsValue verwenden, wird die in dem Date Objekt gespeicherte Minute um 1 erhöht und 40 wird für die Sekunden verwendet.
Da setSeconds() in der lokalen Zeit arbeitet, kann das Überqueren einer Sommerzeitgrenze (DST) zu einer anderen verstrichenen Zeit als erwartet führen. Zum Beispiel, wenn das Einstellen der Sekunden eine Vorwärtsumstellung (Verlust einer Stunde) überschreitet, ist der Unterschied in den Zeitstempeln zwischen dem neuen und alten Datum eine Stunde weniger als der nominale Zeitunterschied. Umgekehrt führt das Überqueren einer Rückwärtsumstellung (Gewinn einer Stunde) zu einer zusätzlichen Stunde. Wenn Sie das Datum um einen festen Zeitraum anpassen müssen, sollten Sie setUTCSeconds() oder setTime() verwenden.
Wenn die neue lokale Zeit innerhalb einer Offset-Transition fällt, wird die genaue Zeit mit demselben Verhalten wie die Temporal disambiguation: "compatible" Option abgeleitet. Das heißt, wenn die lokale Zeit zwei Instanzen entspricht, wird die frühere gewählt; wenn die lokale Zeit nicht existiert (es gibt eine Lücke), gehen wir um die Dauer der Lücke vorwärts.
Beispiele
Verwendung von setSeconds()
const theBigDay = new Date();
theBigDay.setSeconds(30);
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.setseconds |