toLocaleString, méthode

Article
08/21/2008

Mise à jour : novembre 2007

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.

Remarque :
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() {
   // 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);
}

Configuration requise

Version 1

S'applique à :

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

Voir aussi

Autres ressources

Méthodes

Partager via