Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Date.prototype.setSeconds()

Baseline
Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Die Methode setSeconds() von Date-Instanzen ändert die Sekunden und/oder Millisekunden dieses Datums 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: "Tue Aug 19 1975 23:15:42 GMT+0100 (CET)"
// Note: your timezone may vary

Syntax

js
setSeconds(secondsValue)
setSeconds(secondsValue, msValue)

Parameter

secondsValue

Eine Ganzzahl zwischen 0 und 59, die die Sekunden angibt.

msValue Optional

Eine Ganzzahl zwischen 0 und 999, die die Millisekunden angibt.

Rückgabewert

Ändert das Date-Objekt direkt und gibt seinen neuen Zeitstempel zurück. Wenn ein Parameter NaN ist (oder ein anderer Wert, der zu NaN konvertiert wird, beispielsweise undefined), wird das Datum auf Invalid Date gesetzt und NaN zurückgegeben.

Beschreibung

Wenn Sie den Parameter msValue nicht angeben, wird der von der Methode getMilliseconds() zurückgegebene Wert verwendet.

Wenn ein angegebener Parameter außerhalb des erwarteten Bereichs liegt, versucht setSeconds(), die Datumsangaben im Date-Objekt entsprechend anzupassen. Wenn Sie beispielsweise 100 für secondsValue verwenden, wird die im Date-Objekt gespeicherte Minutenzahl um 1 erhöht und für die Sekunden der Wert 40 verwendet.

Da setSeconds() mit der lokalen Zeit arbeitet, kann beim Überschreiten eines Wechsels zwischen Sommer- und Normalzeit eine andere Zeitspanne vergehen als erwartet. Wenn durch das Setzen der Sekunden beispielsweise ein Wechsel zur Sommerzeit überschritten wird, bei dem eine Stunde übersprungen wird, ist die Differenz zwischen den Zeitstempeln des neuen und des alten Datums eine Stunde kleiner als die nominelle Zeitdifferenz. Beim Überschreiten eines Wechsels zur Normalzeit, bei dem eine Stunde hinzukommt, ist sie dagegen eine Stunde größer. Wenn Sie das Datum um eine feste Zeitspanne ändern müssen, sollten Sie setUTCSeconds() oder setTime() verwenden.

Wenn die neue lokale Zeit in einen Zeitzonenwechsel fällt, wird der genaue Zeitpunkt nach demselben Verfahren bestimmt wie bei der Option disambiguation: "compatible" von Temporal: Entspricht die lokale Zeit zwei Zeitpunkten, wird der frühere gewählt. Existiert die lokale Zeit nicht, weil sie in eine Zeitlücke fällt, wird sie um die Dauer dieser Lücke nach vorn verschoben.

Beispiele

Verwendung von setSeconds()

js
const theBigDay = new Date();
theBigDay.setSeconds(30);

Spezifikationen

Spezifikation
ECMAScript® 2027 Language Specification
# sec-date.prototype.setseconds

Browser-Kompatibilität

Siehe auch