Intl.DurationFormat.prototype.formatToParts()

Syntax

formatToParts(duration)

Parameter

duration Optional

Das zu formatierende Dauerobjekt. Es sollte einige oder alle der folgenden Eigenschaften enthalten: years, months, weeks, days, hours, minutes, seconds, milliseconds, microseconds, nanoseconds. Der Wert jeder Eigenschaft sollte ein ganzzahliger Wert sein, und deren Vorzeichen sollten konsistent sein. Dies kann ein Temporal.Duration-Objekt sein; siehe die Temporal.Duration-Dokumentation für weitere Informationen über diese Eigenschaften.

Rückgabewert

Ein Array von Objekten, die die formatierte Dauer in Teilen enthalten. Jedes Objekt hat zwei oder drei Eigenschaften: type, value und optional unit, die jeweils eine Zeichenfolge enthalten. Die Zeichenfolgen-Verkettung von value, in der angegebenen Reihenfolge, ergibt denselben String wie format(). Die Teile können als direkt von einem Aufruf von Intl.NumberFormat.prototype.formatToParts() mit dem numerischen Wert und ihren jeweiligen Einheiten gewonnen betrachtet werden. Alle Tokens, die von NumberFormat produziert werden, haben eine zusätzliche unit-Eigenschaft, die die Singularform der Eingabe unit ist; dies ist für programmatische Verwendung und ist nicht lokalisiert. Die lokalisierte Einheit wird als separates unit-Token als Teil des NumberFormat-Ergebnisses ausgegeben. Die Teile jeder Dauereinheit werden auf die gleiche Weise zusammengefügt, wie ein Aufruf von Intl.ListFormat.prototype.formatToParts() mit { type: "unit" }, so dass zusätzliche Literal-Tokens eingefügt werden.

Beispiele

Die formatToParts Methode ermöglicht eine lokalisierte Formatierung von Strings, die von DurationFormat Formatierern erzeugt werden, indem Sie Ihnen den String in Teilen bereitstellt:

const duration = {
  hours: 7,
  minutes: 8,
  seconds: 9,
  milliseconds: 123,
  microseconds: 456,
  nanoseconds: 789,
};

new Intl.DurationFormat("en", { style: "long" }).formatToParts(duration);

// Returned value:
[
  { type: "integer", value: "7", unit: "hour" },
  { type: "literal", value: " ", unit: "hour" },
  { type: "unit", value: "hours", unit: "hour" },
  { type: "literal", value: ", " },
  { type: "integer", value: "8", unit: "minute" },
  { type: "literal", value: " ", unit: "minute" },
  { type: "unit", value: "minutes", unit: "minute" },
  { type: "literal", value: ", " },
  { type: "integer", value: "9", unit: "second" },
  { type: "literal", value: " ", unit: "second" },
  { type: "unit", value: "seconds", unit: "second" },
  { type: "literal", value: ", " },
  { type: "integer", value: "123", unit: "millisecond" },
  { type: "literal", value: " ", unit: "millisecond" },
  { type: "unit", value: "milliseconds", unit: "millisecond" },
  { type: "literal", value: ", " },
  { type: "integer", value: "456", unit: "microsecond" },
  { type: "literal", value: " ", unit: "microsecond" },
  { type: "unit", value: "microseconds", unit: "microsecond" },
  { type: "literal", value: ", " },
  { type: "integer", value: "789", unit: "nanosecond" },
  { type: "literal", value: " ", unit: "nanosecond" },
  { type: "unit", value: "nanoseconds", unit: "nanosecond" },
];

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Intl.DurationFormat
• Intl.DurationFormat.prototype.format()
• Temporal.Duration