Die Methode Date.prototype.toLocaleTimeString() gibt ausschließlich den Zeitanteil eines Date-Objekts als lokalisierten String zurück. Sie ist das Pendant zu toLocaleDateString() und wird typischerweise für Uhrzeit-Anzeigen, Live-Ticker oder Zeitstempel in Chat-Anwendungen verwendet. Über die options lässt sich zwischen 12- und 24-Stunden-Format umschalten und die Detailtiefe steuern.
Funktionsweise
Wie die übrigen toLocale*-Methoden delegiert sie an Intl.DateTimeFormat. Die Locale steuert vor allem:
- 12- vs. 24-Stunden-Format (in englischer Locale standardmäßig 12 h, in deutscher 24 h).
- Trennzeichen (Doppelpunkt vs. Punkt).
- Formatierung von Sekunden und Sub-Sekunden.
Syntax
date.toLocaleTimeString()
date.toLocaleTimeString(locales)
date.toLocaleTimeString(locales, options)locales (Optional) Ein BCP-47-Sprachcode oder ein Array davon.
options (Optional) Ein Objekt mit Formatierungsoptionen wie timeStyle, hour, minute, second, hour12, timeZone, timeZoneName.
Rückgabewert
Ein lokalisierter String mit dem Zeitanteil.
Beispiele
Standard-Zeitausgabe
const date = new Date("2026-05-01T14:30:42");
console.log(date.toLocaleTimeString("de-DE"));14:30:42Locale-Vergleich
const date = new Date("2026-05-01T14:30:00");
console.log(date.toLocaleTimeString("de-DE"));
console.log(date.toLocaleTimeString("en-US"));
console.log(date.toLocaleTimeString("en-GB"));14:30:00
2:30:00 PM
14:30:00Nur Stunden und Minuten
const date = new Date("2026-05-01T14:30:42");
const text = date.toLocaleTimeString("de-DE", {
hour: "2-digit",
minute: "2-digit"
});
console.log(text);14:30timeStyle als Kurzform
const date = new Date("2026-05-01T14:30:42");
console.log(date.toLocaleTimeString("de-DE", { timeStyle: "full" }));
console.log(date.toLocaleTimeString("de-DE", { timeStyle: "long" }));
console.log(date.toLocaleTimeString("de-DE", { timeStyle: "medium" }));
console.log(date.toLocaleTimeString("de-DE", { timeStyle: "short" }));14:30:42 Mitteleuropäische Sommerzeit
14:30:42 MESZ
14:30:42
14:3012-Stunden-Format erzwingen
const date = new Date("2026-05-01T14:30:00");
console.log(date.toLocaleTimeString("de-DE", { hour12: true }));02:30:00 PMHinweise & verwandte Methoden
- Für viele Zeit-Formatierungen in Folge:
Intl.DateTimeFormatist performanter. - Für Datum + Zeit:
toLocaleString(). Für nur Datum:toLocaleDateString(). - Die genaue Formatierung kann sich zwischen Browser-Versionen leicht ändern – für stabile Ausgaben nicht auf eine exakte String-Form verlassen, sondern via Optionen kontrollieren.
- Default-Locale unbedingt explizit setzen, wenn das Format reproduzierbar sein soll (insbesondere auf Servern).