Intl.RelativeTimeFormat.prototype.formatToParts()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.
Die Methode formatToParts() von Instanzen des Intl.RelativeTimeFormat gibt ein Array von Objekten zurück, die das relative Zeitformat in Teilen darstellen, die für benutzerdefinierte, lokalisierungsbewusste Formatierung verwendet werden können.
Probieren Sie es aus
Syntax
formatToParts(value, unit)
Parameter
value-
Numerischer Wert, der in der internationalisierten relativen Zeitnachricht verwendet wird.
unit-
Einheit, die in der internationalisierten relativen Zeitnachricht verwendet wird. Mögliche Werte sind:
"year","quarter","month","week","day","hour","minute","second". Pluralformen sind ebenfalls erlaubt.
Rückgabewert
Ein Array von Objekten, die die formatierte relative Zeit in Teilen enthalten.
Beschreibung
Die Methode Intl.RelativeTimeFormat.prototype.formatToParts ist eine Version der Formatmethode, die ein Array von Objekten zurückgibt, die "Teile" des Objekts darstellen. Dabei wird die formatierte Zahl in ihre Bestandteile zerlegt und von anderen umgebenden Texten getrennt. Diese Objekte haben zwei Eigenschaften: Typ, ein NumberFormat formatToParts Typ, und Wert, welcher der String ist, der die Komponente der Ausgabe darstellt. Wenn ein "Teil" aus NumberFormat stammt, wird er eine Einheitseigenschaft haben, die die formatierte Einheit anzeigt; Literale, die Teil des größeren Rahmens sind, werden diese Eigenschaft nicht haben.
Beispiele
Verwendung von formatToParts
const rtf = new Intl.RelativeTimeFormat("en", { numeric: "auto" });
// Format relative time using the day unit
rtf.formatToParts(-1, "day");
// [{ type: "literal", value: "yesterday"}]
rtf.formatToParts(100, "day");
// [
// { type: "literal", value: "in " },
// { type: "integer", value: "100", unit: "day" },
// { type: "literal", value: " days" }
// ]
Spezifikationen
| Specification |
|---|
| ECMAScript Internationalization API Specification # sec-Intl.RelativeTimeFormat.prototype.formatToParts |
Browser-Kompatibilität
BCD tables only load in the browser