Die Methode Date.prototype.getSeconds() gibt die Sekundenkomponente eines Date-Objekts in der lokalen Zeitzone zurück. Der Rückgabewert liegt zwischen 0 und 59 und vervollständigt damit zusammen mit getHours(), getMinutes() und getMilliseconds() die Zerlegung einer Uhrzeit. Sie ist nicht zu verwechseln mit getTime(), das den absoluten Zeitstempel in Millisekunden seit der Unix-Epoche liefert.
Funktionsweise
getSeconds() extrahiert ausschließlich den Sekundenanteil eines Zeitpunktes. Da Zeitzonen typischerweise nicht im Sekundenbereich variieren, stimmt der Wert in der Praxis stets mit dem von getUTCSeconds() überein. Schaltsekunden werden von JavaScript-Date-Objekten nicht abgebildet.
Syntax
date.getSeconds()Die Methode erwartet keine Parameter.
Rückgabewert
Eine Ganzzahl zwischen 0 und 59. Bei einem ungültigen Datum wird NaN zurückgegeben.
Beispiele
Sekunden auslesen
const date = new Date("2026-05-01T14:30:42");
console.log(date.getSeconds());42Uhrzeit als HH:MM:SS formatieren
function formatTime(date) {
const hh = String(date.getHours()).padStart(2, "0");
const mm = String(date.getMinutes()).padStart(2, "0");
const ss = String(date.getSeconds()).padStart(2, "0");
return `${hh}:${mm}:${ss}`;
}
console.log(formatTime(new Date("2026-05-01T09:05:08")));09:05:08Countdown-Timer mit Sekundenausgabe
function verbleibend(ziel, jetzt) {
const diffSec = Math.floor((ziel.getTime() - jetzt.getTime()) / 1000);
const minuten = Math.floor(diffSec / 60);
const sekunden = diffSec % 60;
return `${minuten}m ${sekunden}s`;
}
const jetzt = new Date("2026-05-01T14:30:00");
const ziel = new Date("2026-05-01T14:35:42");
console.log(verbleibend(ziel, jetzt));5m 42sVolle Minute prüfen
function istVolleMinute(date) {
return date.getSeconds() === 0 && date.getMilliseconds() === 0;
}
console.log(istVolleMinute(new Date("2026-05-01T14:30:00.000")));
console.log(istVolleMinute(new Date("2026-05-01T14:30:05.000")));true
falseHinweise & verwandte Methoden
- Für eine zeitzonenunabhängige Variante:
Date.prototype.getUTCSeconds()– liefert in praktisch allen Fällen denselben Wert. - Zum Setzen der Sekunden:
Date.prototype.setSeconds()– kann optional auch Millisekunden setzen. - Für kumulative Zeitangaben (z. B. „wie viele Sekunden sind seit Mitternacht vergangen?”) niemals
getSeconds()direkt verwenden, sondern ausgetHours() * 3600 + getMinutes() * 60 + getSeconds()berechnen.