Number.prototype.toLocaleString()

Die neuen locales und options Argumente ermöglichen es Anwendungen, sprachübliche Formatierungskonventionen zu benutzen und diese anzupassen. In älteren Implementierungen werden die locales und options Argumente ignoriert, und die Formatierung des Strings ist implementierungsabhängig.

Syntax

numObj.toLocaleString([locales [, options]])

Parameter

Prüfe die Browserkompatibilität, um zu sehen, welcher Browser den locales und options Parameter unterstützt, und das Beispiel Unterstützung für locales und options Argumente prüfen für eine Funktionalitätsprüfung.

Rückgabewert

Einen String, der die gegebene Zahl in einer sprachspezifischen Formatierung repräsentiert.

Beispiele

Einsatz von toLocaleString()

Bei der Nutzung ohne Parameter wird der string in der Standardsprache ohne Optionen zurückgegeben:

var number = 3500;

console.log(number.toLocaleString()); // Ausgabe: "3.500" wenn in Deutscher locale

Unterstützung für locales und options Argumente prüfen

Die locales und options Argumente sind noch nicht in allen Browsern unterstützt. Zur Prüfung der Unterstützung von ES5.1 und neueren Implementierungen wird vorausgesetzt, dass unbekannte Sprachen zu einem RangeError führen, was folgendermaßen eingesetzt werden kann:

function toLocaleStringSupportsLocales() {
  var number = 0;
  try {
    number.toLocaleString('i');
  } catch (e) {
    return e.name === 'RangeError';
  }
  return false;
}

Vor ES5.1 mussten die Implementierungen keinen RangeError erzeugen, wenn toLocaleString  mit Argumenten aufgerufen wurde.

Eine Prüfung, die in allen Browser funktioniert, auch in denen, die ECMA-262 vor ES5.1 unterstützen, ist die Prüfung auf Funktionen aus ECMA-402, welche Optionen in Number.prototype.toLocaleString direkt unterstützen:

function toLocaleStringSupportsOptions() {
  return !!(typeof Intl == 'object' && Intl && typeof Intl.NumberFormat == 'function');
}

Diese Tests auf dem globalen Intl Objekt prüfen, ob das Objekt existiert und die Eigenschaft vom Typ Funktion Intl.NumberFormat hat.

Einsatz von locales

Diese Beispiel zeigt einige der Variationen in Internationalen Zahlenformaten. Um das Format der Sprache zu bekommen, welches in der Anwendung benutzt wird, spezifiziere die Sprache (und mögliche Rückfallsprachen (fallback)) mit dem locales Argument.

var number = 123456.789;

// Englische Benutzer sehen ein Punkt anstatt eines Kommas als Dezimaltrenner
console.log(number.toLocaleString('en-GB'));
// → 123.456,789

// Arabisch ist in den meisten arabisch Sprechenden Ländern eingesetzt (Eastern Arabic) Ziffern
console.log(number.toLocaleString('ar-EG'));
// → ١٢٣٤٥٦٫٧٨٩

// Indien benutzt Tausendertrennzeichen bei Tausend und allen weiteren zwei Stellen 
console.log(number.toLocaleString('en-IN'));
// → 1,23,456.789

// Chinesisches Zahlensystem
console.log(number.toLocaleString('zh-Hans-CN-u-nu-hanidec'));
// → 一二三,四五六.七八九

// Wenn eine Sprache übergeben werden soll, die vielleicht nicht
// unterstützt wird (Balinesisch), nutze eine fallback Sprache (Indonesisch)
console.log(number.toLocaleString(['ban', 'id']));
// → 123.456,789

Einsatz von options

Das Ergebnis von toLocaleString  kann durch das options Argument angepasst werden.

var number = 123456.789;

// Währungsformat
console.log(number.toLocaleString('de-DE', { style: 'currency', currency: 'EUR' }));
// → 123.456,79 €

// Der Japanische Yen hat keine Unterwährung (z. B. Cent) 
console.log(number.toLocaleString('ja-JP', { style: 'currency', currency: 'JPY' }))
// → ￥123,457

// Limitiert auf drei signifikante Stellen 
console.log(number.toLocaleString('en-IN', { maximumSignificantDigits: 3 }));
// → 1,23,000

Performance

Wenn eine lange Zahl formatiert werden soll, ist es besser ein NumberFormat Objekt zu erstellen und die Funktion NumberFormat.format zu benutzen.

Spezifikationen

Browserkompatibilität

Siehe auch

• Number.prototype.toString()