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

JavaScript 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

JavaScript Beispiel
const date = new Date("2026-05-01T14:30:42");
console.log(date.getSeconds());
Output
42

Uhrzeit als HH:MM:SS formatieren

JavaScript Beispiel
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")));
Output
09:05:08

Countdown-Timer mit Sekundenausgabe

JavaScript Beispiel
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));
Output
5m 42s

Volle Minute prüfen

JavaScript Beispiel
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")));
Output
true
false

Hinweise & 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 aus getHours() * 3600 + getMinutes() * 60 + getSeconds() berechnen.
/ Weiter

Zurück zu Date

Zur Übersicht