BigInt.prototype.toLocaleString()

Probieren Sie es aus

const bigint = 123456789123456789n;

// German uses period for thousands
console.log(bigint.toLocaleString("de-DE"));
// Expected output: "123.456.789.123.456.789"

// Request a currency format
console.log(
  bigint.toLocaleString("de-DE", { style: "currency", currency: "EUR" }),
);
// Expected output: "123.456.789.123.456.789,00 "

Syntax

toLocaleString()
toLocaleString(locales)
toLocaleString(locales, options)

Parameter

Die Parameter locales und options passen das Verhalten der Funktion an und ermglichen es Anwendungen, die Sprache zu spezifizieren, deren Formatierungskonventionen verwendet werden sollen.

In Implementierungen, die die Intl.NumberFormat API untersttzen, entsprechen diese Parameter genau den Parametern des Intl.NumberFormat() Konstruktors. Implementierungen ohne Intl.NumberFormat Untersttzung ignorieren beide Parameter, wodurch die verwendete Sprache und die Form des zurckgegebenen Strings vollstndig von der Implementierung abhngen.

locales Optional

Ein String mit einem BCP 47 Sprach-Tag oder ein Array solcher Strings. Entspricht dem locales Parameter des Intl.NumberFormat() Konstruktors.

In Implementierungen ohne Intl.NumberFormat Untersttzung wird dieser Parameter ignoriert und normalerweise die Sprache des Hosts verwendet.

options Optional

Ein Objekt, das das Ausgabeformat anpasst. Entspricht dem options Parameter des Intl.NumberFormat() Konstruktors.

In Implementierungen ohne Intl.NumberFormat Untersttzung wird dieser Parameter ignoriert.

Sehen Sie den Intl.NumberFormat() Konstruktor fr Details zu diesen Parametern und wie sie verwendet werden knnen.

Rckgabewert

Ein String, der das gegebene BigInt gem sprachspezifischen Konventionen darstellt.

In Implementierungen mit Intl.NumberFormat entspricht dies new Intl.NumberFormat(locales, options).format(number).

Beispiele

Verwendung von toLocaleString()

Die grundlegende Nutzung dieser Methode ohne Angabe einer locale gibt einen formatierten String in der Standardsprache und mit Standardoptionen zurck.

const bigint = 3500n;

console.log(bigint.toLocaleString());
// "3,500" if in U.S. English locale

berprfung der Untersttzung fr locales- und options-Parameter

Die locales und options Parameter knnen in allen Implementierungen nicht untersttzt werden, da die Untersttzung fr die Internationalisierungs-API optional ist, und einige Systeme mglicherweise nicht ber die erforderlichen Daten verfgen. Fr Implementierungen ohne Untersttzung fr Internationalisierung verwendet toLocaleString() immer die Systemsprache, die mglicherweise nicht Ihren Vorstellungen entspricht. Da jede Implementierung, die die locales und options Parameter untersttzt, auch die Intl API untersttzen muss, knnen Sie die Existenz der letzteren auf Untersttzung berprfen:

function toLocaleStringSupportsLocales() {
  return (
    typeof Intl === "object" &&
    !!Intl &&
    typeof Intl.NumberFormat === "function"
  );
}

Verwendung von locales

Dieses Beispiel zeigt einige der Variationen in lokalisierten Nummernformaten. Um das Format der Sprache zu erhalten, die in der Benutzeroberflche Ihrer Anwendung verwendet wird, sollten Sie sicherstellen, dass Sie diese Sprache (und mglicherweise einige Ersatzsprachen) mit dem locales Argument angeben:

const bigint = 123456789123456789n;

// German uses period for thousands
console.log(bigint.toLocaleString("de-DE"));
// 123.456.789.123.456.789

// Arabic in most Arabic speaking countries uses Eastern Arabic digits
console.log(bigint.toLocaleString("ar-EG"));
// 

// India uses thousands/lakh/crore separators
console.log(bigint.toLocaleString("en-IN"));
// 1,23,45,67,89,12,34,56,789

// the nu extension key requests a numbering system, e.g. Chinese decimal
console.log(bigint.toLocaleString("zh-Hans-CN-u-nu-hanidec"));
// ,,,,,

// when requesting a language that may not be supported, such as
// Balinese, include a fallback language, in this case Indonesian
console.log(bigint.toLocaleString(["ban", "id"]));
// 123.456.789.123.456.789

Verwendung von options

Die durch toLocaleString() bereitgestellten Ergebnisse knnen mit dem options Parameter angepasst werden:

const bigint = 123456789123456789n;

// request a currency format
console.log(
  bigint.toLocaleString("de-DE", { style: "currency", currency: "EUR" }),
);
// 123.456.789.123.456.789,00 

// the Japanese yen doesn't use a minor unit
console.log(
  bigint.toLocaleString("ja-JP", { style: "currency", currency: "JPY" }),
);
// 123,456,789,123,456,789

// limit to three significant digits
console.log(bigint.toLocaleString("en-IN", { maximumSignificantDigits: 3 }));
// 1,23,00,00,00,00,00,00,000

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Intl.NumberFormat
• BigInt.prototype.toString()