toLocaleString, méthode

Retourne une valeur convertie en valeur de chaîne en fonction des paramètres régionaux définis pour l'environnement hôte.

function toLocaleString() : String

Notes

En ce qui concerne l'objet Array, les éléments du tableau sont convertis en chaînes, puis celles-ci sont concaténées et retournées, les chaînes étant séparées par le séparateur de liste spécifié dans les paramètres régionaux en cours pour l'environnement hôte.

Pour l'objet Date, la méthode toLocaleString retourne un objet String qui contient la date écrite dans le format long par défaut spécifié dans les paramètres régionaux en cours.

• Pour les dates comprises entre 1601 et 9999 après J.-C., la date est écrite dans le format correspondant aux paramètres régionaux définis par l'utilisateur dans le Panneau de configuration.

• Pour les dates en dehors de cette plage, c'est le format par défaut de la méthode toString qui est utilisé.

Pour l'objet Number, la méthode toLocaleString retourne une valeur de chaîne représentant la valeur du nombre dans le format spécifié dans les paramètres régionaux en cours pour l'environnement hôte.

Pour les objets Object, la méthode ToLocaleString est fournie en vue d'offrir à tous les objets les fonctionnalités génériques de la méthode toLocaleString, même si ces objets n'y ont pas recours.

Notes

N'utilisez toLocaleString que pour afficher les résultats à l'utilisateur ; ne vous en servez pas comme base d'un calcul dans un script étant donné que le résultat retourné varie en fonction de chaque ordinateur.

Exemple

L'exemple suivant illustre l'utilisation côté client de la méthode toLocaleString avec un objet Array, Date et 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);
}

Configuration requise

Version 1

S'applique à :

Objet Array| Date, objet| Number, objet| Object, objet

Voir aussi

Autres ressources

Méthodes