Temporal.Instant.prototype.toLocaleString()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die toLocaleString()-Methode von Temporal.Instant Instanzen gibt eine sprachsensitive Darstellung dieses Zeitpunktes als Zeichenfolge zurück. In Implementierungen mit Unterstützung für die Intl.DateTimeFormat API delegiert diese Methode an Intl.DateTimeFormat.
Jedes Mal, wenn toLocaleString aufgerufen wird, muss eine Suche in einer großen Datenbank mit Lokalisierungsstrings durchgeführt werden, was potenziell ineffizient ist. Wenn die Methode häufig mit denselben Argumenten aufgerufen wird, ist es besser, ein Intl.DateTimeFormat-Objekt zu erstellen und dessen format()-Methode zu verwenden. Ein DateTimeFormat-Objekt merkt sich die übergebenen Argumente und kann entscheiden, einen Teil der Datenbank zwischenspeichern, sodass zukünftige format-Aufrufe Lokalisierungsstrings in einem eingeschränkteren Kontext suchen können.
Syntax
toLocaleString()
toLocaleString(locales)
toLocaleString(locales, options)
Parameter
Die Parameter locales und options passen das Verhalten der Funktion an und ermöglichen es Anwendungen, die Sprache festzulegen, 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 Unterstützung für Intl.DateTimeFormat geben exakt denselben String zurück wie toString(), wobei beide Parameter ignoriert werden.
localesOptional-
Ein String mit einem BCP 47 Sprach-Tag oder ein Array solcher Strings. Entspricht dem
locales-Parameter desIntl.DateTimeFormat()-Konstruktors. optionsOptional-
Ein Objekt zur Anpassung des Ausgabformats. Entspricht dem
options-Parameter desIntl.DateTimeFormat()-Konstruktors.
Details zu diesen Parametern und deren Verwendung finden Sie beim Intl.DateTimeFormat()-Konstruktor.
Rückgabewert
Ein Zeichenfolge, die den gegebenen Zeitpunkt nach sprachspezifischen Konventionen darstellt.
In Implementierungen mit Intl.DateTimeFormat entspricht dies new Intl.DateTimeFormat(locales, options).format(instant).
Hinweis:
Meistens ist das von toLocaleString() zurückgegebene Format konsistent. Allerdings kann die Ausgabe zwischen Implementierungen variieren, selbst innerhalb desselben Gebietsschemas — Variationen in der Ausgabe sind gewollt und durch die Spezifikation erlaubt. Es könnte auch nicht das sein, was Sie erwarten. Zum Beispiel könnte der String geschützte Leerzeichen verwenden oder von bidirektionalen Steuerzeichen umgeben sein. Sie sollten die Ergebnisse von toLocaleString() nicht mit festkodierten Konstanten vergleichen.
Beispiele
Verwendung von toLocaleString()
Die grundlegende Verwendung dieser Methode ohne Angabe eines locale gibt einen formatierten String im Standardgebietsschema und mit Standardoptionen zurück.
const instant = Temporal.Instant.from("2021-08-01T12:34:56Z");
console.log(instant.toLocaleString()); // 8/1/2021, 12:34:56 AM (assuming en-US locale and device in UTC time zone)
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.instant.prototype.tolocalestring |
Browser-Kompatibilität
Loading…