WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Intl.NumberFormat: Optionen für Währungen und Prozentwerte

Formatiere Beträge und Anteile passend zur Sprache und Region. Erfahre, wann ein Währungscode nötig ist, warum 0,125 für 12,5 % steht und wie sich die Nachkommastellen einstellen lassen.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

new Intl.NumberFormat(locale, { style: "currency", currency: "USD" }).format(amount)
new Intl.NumberFormat(locale, { style: "percent", minimumFractionDigits: 1, maximumFractionDigits: 1 }).format(ratio)

new Intl.NumberFormat(locale, options) erstellt einen wiederverwendbaren Formatierer; format(value) liefert lokalisierten Text. Die Sprache und Region beeinflussen etwa Trennzeichen und die Position von Symbolen. style legt die Darstellungsart fest und ist ohne Angabe "decimal".

Bei style: "currency" gibst du mit currency einen Währungscode wie "USD" an. Übergib den Betrag in der Hauptwährungseinheit, nicht in Cent: Die Formatierung rechnet keine Währungen um. Fehlt der Code, wird ein TypeError ausgelöst. Besteht der Code nicht aus drei ASCII-Buchstaben, ist es ein RangeError. Ein formal gültiger Code muss keiner Währung zugeordnet sein. currencyDisplay wählt "symbol" (Standard), "narrowSymbol" (schmaleres Symbol), "code" oder "name". currencySign ist standardmäßig "standard"; mit "accounting" können negative Beträge je nach Sprache und Region in Klammern stehen.

Bei style: "percent" übergibst du einen Anteil: Die Formatierung multipliziert ihn vor dem Runden mit 100. Für 12,5 % übergibst du 0.125, nicht 12.5. Bei Standardnotation und ohne Einstellungen für signifikante Stellen richtet sich die voreingestellte Zahl der Nachkommastellen nach der Untereinheit der Währung (zwei für USD). Prozentwerte haben standardmäßig keine Nachkommastellen. minimumFractionDigits füllt bei Bedarf mit Nullen auf; maximumFractionDigits begrenzt die Nachkommastellen beim Runden. Mit der Standardeinstellung trailingZeroDisplay: "auto" setzt du beide auf denselben Wert, um genau so viele Nachkommastellen anzuzeigen. Bei trailingZeroDisplay: "stripIfInteger" entfällt der Nachkommateil, wenn das gerundete Ergebnis eine ganze Zahl ist.

Lokalisierungsdaten und Laufzeitunterstützung können variieren. Leerzeichen und Symbole können selbst bei derselben Sprache und Region abweichen. Vergleiche deshalb nicht die gesamte lokalisierte Zeichenkette mit einem fest vorgegebenen Wert. Mit formatToParts() kannst du die Bestandteile nach Typ prüfen.

Beispiele

const locale = "en-US-u-nu-latn";
const money = new Intl.NumberFormat(locale, {
  style: "currency",
  currency: "USD",
  currencyDisplay: "code",
});
const percent = new Intl.NumberFormat(locale, {
  style: "percent",
  minimumFractionDigits: 1,
  maximumFractionDigits: 1,
});

const moneyParts = money.formatToParts(19.9);
const percentParts = percent.formatToParts(0.125);
const valueOf = (parts, type) => parts.find(part => part.type === type)?.value;

console.log(JSON.stringify([
  valueOf(moneyParts, "currency"),
  valueOf(moneyParts, "integer"),
  valueOf(moneyParts, "fraction"),
]));
console.log(JSON.stringify([
  valueOf(percentParts, "integer"),
  valueOf(percentParts, "fraction"),
  percentParts.some(part => part.type === "percentSign"),
]));

Ergebnis

["USD","19","90"]
["12","5",true]

Die erste Zeile zeigt den USD-Code und beide Teile des Betrags einschließlich der abschließenden Null. Die zweite zeigt die Zahlenteile von 12,5 % und bestätigt, dass ein Prozentzeichen vorhanden ist, ohne dessen genaues Zeichen oder Position zu prüfen.

Zugehörige Lektionen

  • JavaScript · Lektion 24 · Mittlere Stufe · Version: 3

Quellen