Freigeben über


toLocaleString-Methode

Aktualisiert: November 2007

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.

Hinweis:

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() {
   // Declare variables.
   var myArray = new Array(6);
   var i;
   // Initialize string.
   var s = "The array contains: ";
   // Populate array with values.
   for(i = 0;i < 7; i++)
   {
      // Make value same as index.
      myArray[i] = i;
   }
   s += myArray.toLocaleString();
   return(s);
}
function toLocaleStringDate() {
   // Declare variables.
   var d = new Date();
   var s = "Current date setting is ";
   // Convert to current locale.
   s += d.toLocaleString();
   return(s);
}
function toLocaleStringNumber() {
   var n = Math.PI;
   var s = "The value of Pi is: ";
   s+= n.toLocaleString();
   return(s);
}

Anforderungen

Version 1

Betrifft:

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

Siehe auch

Weitere Ressourcen

Methoden