Date.prototype.toLocaleTimeString()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Die toLocaleTimeString() Methode von Date Instanzen gibt einen String mit einer sprachsensitiven Darstellung des Zeitanteils dieses Datums in der lokalen Zeitzone zurück. In Implementierungen mit Unterstützung für die Intl.DateTimeFormat API delegiert diese Methode an Intl.DateTimeFormat.
Jedes Mal, wenn toLocaleTimeString aufgerufen wird, muss eine Suche in einer großen Datenbank von Lokalisierungsstrings durchgeführt werden, was potenziell ineffizient ist. Wenn die Methode viele Male mit den gleichen Argumenten aufgerufen wird, ist es besser, ein Intl.DateTimeFormat Objekt zu erstellen und dessen format() Methode zu verwenden, da ein DateTimeFormat Objekt sich die übergebenen Argumente merkt und möglicherweise entscheidet, einen Teil der Datenbank zu cachen, sodass zukünftige format Aufrufe in einem eingeschränkteren Kontext nach Lokalisierungsstrings suchen können.
Probieren Sie es aus
Syntax
Parameter
Die locales und options Parameter passen das Verhalten der Funktion an und lassen Anwendungen die Sprache spezifizieren, deren Formatierungskonventionen verwendet werden sollen.
In Implementierungen, die die Intl.DateTimeFormat API unterstützen, entsprechen diese Parameter genau den Parametern des Intl.DateTimeFormat() Konstruktors. Implementierungen ohne Intl.DateTimeFormat Unterstützung ignorieren beide Parameter, was die verwendete Locale und die Form des zurückgegebenen Strings vollständig implementierungsabhängig macht.
localesOptional-
Ein String mit einem BCP 47 Sprach-Tag oder ein Array solcher Strings. Entspricht dem
localesParameter desIntl.DateTimeFormat()Konstruktors.In Implementierungen ohne
Intl.DateTimeFormatUnterstützung wird dieser Parameter ignoriert und normalerweise die Locale des Hosts verwendet. optionsOptional-
Ein Objekt, das das Ausgabeformat anpasst. Entspricht dem
optionsParameter desIntl.DateTimeFormat()Konstruktors. WenndayPeriod,hour,minute,secondundfractionalSecondDigitsalle undefiniert sind, werdenhour,minute,secondauf"numeric"gesetzt.In Implementierungen ohne
Intl.DateTimeFormatUnterstützung wird dieser Parameter ignoriert.
Siehe den Intl.DateTimeFormat() Konstruktor für Details zu diesen Parametern und deren Verwendung.
Rückgabewert
Ein String, der den Zeitanteil des angegebenen Datums gemäß sprachspezifischer Konventionen darstellt.
In Implementierungen mit Intl.DateTimeFormat entspricht dies new Intl.DateTimeFormat(locales, options).format(date), wobei options wie oben beschrieben normalisiert wurde.
Hinweis:
Meistens ist die von toLocaleTimeString() zurückgegebene Formatierung konsistent. Allerdings kann die Ausgabe zwischen Implementierungen variieren, selbst innerhalb derselben Locale — Abweichungen in der Ausgabe sind durch das Design und die Spezifikation erlaubt. Es ist möglicherweise auch nicht das, was Sie erwarten. Zum Beispiel kann der String geschützte Leerzeichen verwenden oder von bidirektionalen Steuerzeichen umgeben sein. Sie sollten die Ergebnisse von toLocaleTimeString() nicht mit hartkodierten Konstanten vergleichen.
Beispiele
Verwendung von toLocaleTimeString()
Die grundlegende Verwendung dieser Methode ohne Angabe einer locale gibt einen formatierten String in der Standard-Locale und mit Standardoptionen zurück.
Überprüfung der Unterstützung für die locales und options Parameter
Die locales und options Parameter sind möglicherweise nicht in allen Implementierungen unterstützt, da die Unterstützung für die Internationalisierungs-API optional ist und einige Systeme die erforderlichen Daten nicht haben. Für Implementierungen ohne Internationalisierungsunterstützung verwendet toLocaleTimeString() immer die Locale des Systems, was möglicherweise nicht das ist, was Sie möchten. Da jede Implementierung, die die locales und options Parameter unterstützt, auch die Intl API unterstützen muss, können Sie deren Existenz zur Unterstützung prüfen:
Verwendung von locales
Dieses Beispiel zeigt einige der Variationen in lokalisierten Zeitformaten. Um das Format der Sprache zu erhalten, die in der Benutzeroberfläche Ihrer Anwendung verwendet wird, stellen Sie sicher, dass Sie diese Sprache (und möglicherweise einige Fallback-Sprachen) mit dem locales Argument spezifizieren:
Verwendung von options
Die von toLocaleTimeString() bereitgestellten Ergebnisse können mit dem options Parameter angepasst werden:
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.tolocaletimestring |
| ECMAScript® 2026 Internationalization API Specification # sup-date.prototype.tolocaletimestring |