toLocaleString-Methode

Gibt unter Berücksichtigung des aktuellen Gebietsschemas der Hostumgebung einen Wert als Zeichenfolge zurück.

function toLocaleString() : String

Hinweise

Beim Array-Objekt werden die Elemente des Arrays in Zeichenfolgen konvertiert, die anschließend verkettet und zurückgegeben werden. Die einzelnen Zeichenfolgen sind dann durch das Listentrennzeichen getrennt, das im aktuellen Gebietsschema der Hostumgebung festgelegt ist.

Beim Date-Objekt gibt die toLocaleString-Methode ein String-Objekt zurück, das das Datum im langen Standardformat des aktuellen Gebietsschemas enthält.

  • Für Tage zwischen 1601 und 9999 wird das Datum entsprechend den Ländereinstellungen formatiert, die in der Systemsteuerung des Benutzers definiert sind.

  • Für Tage außerhalb dieser Spanne wird das Standardformat der toString-Methode verwendet.

Beim Number-Objekt erstellt toLocaleString eine Zeichenfolge, die dem Wert von Number entspricht und entsprechend dem aktuellen Gebietsschema der Hostumgebung formatiert ist.

Bei Object-Objekten wird für alle Objekte durch ToLocaleString eine allgemeine toLocaleString-Funktion bereitgestellt, auch wenn sie diese nicht verwenden.

Tipp

toLocaleString sollte nur zum Anzeigen der Ergebnisse für den Benutzer verwendet werden und nie als Grundlage zur Berechnung in einem Skript, da das zurückgegebene Ergebnis computerspezifisch ist.

Beispiel

Das folgende Clientbeispiel veranschaulicht die Verwendung der toLocaleString-Methode mit den Objekten Array, Date und Number.

function toLocaleStringArray() {
   // Populate an array with values.
   // Each value is the same as the index.
   var myArray = new Array();
   for(var i = 0; i <= 6; i++)
   {
      myArray[i] = i;
   }

   var s = myArray.toLocaleString();
   return(s);
}

function toLocaleStringDate() {
   var d = new Date();
   var s = d.toLocaleString();
   return(s);
}

function toLocaleStringNumber() {
   var n = Math.PI;
   var s = n.toLocaleString();
   return(s);
}

Anforderungen

Version 1

Betrifft:

Array-Objekt| Date-Objekt| Number-Objekt| Object-Objekt

Siehe auch

Weitere Ressourcen

Methoden