Number.prototype.toFixed()

La méthode toFixed() permet de formater un nombre en notation à point-fixe.

Syntaxe

numObj.toFixed([nbChiffres])

Paramètres

nbChiffres
Le nombre de chiffres qu'on souhaite avoir après le séparateur décimal. Cette valeur peut être comprise, au sens large, entre 0 et 20. Les différentes implémentations peuvent éventuellement supporter des valeurs en dehors de cet intervalle. Si l'argument n'est pas utilisé, la valeur par défaut sera 0.

Valeur de retour

Une chaîne de caractères qui représente le nombre indiqué avec une notation à point fixe.

Exceptions causées

RangeError
Cette exception est renvoyée si nbChiffres est trop grand ou trop petit. Les valeurs comprises, au sens large, entre 0 et 20, n'entraîneront pas de RangeError. Les différentes implémentations peuvent ou non supporter des valeurs plus petites et/ou plus grandes.
TypeError
Cette exception est renvoyée si cette méthode est invoquée depuis un objet qui n'est pas de type numérique.

Description

toFixed() renvoie une chaîne de caractères représentant objetNumber sans notation exponentielle et qui possède exactement nbChiffres pour la partie fractionnaire. Le nombre est arrondi si nécessaire et la partie fractionnaire est complétée par des zéros si nécessaire pour obtenir la longueur souhaitée. Si le objetNumber est supérieur à 1e+21, la méthode utilise simplement Number.prototype.toString() et renvoie une chaîne en notation exponentielle.

Exemples

Utiliser toFixed

var numObj = 12345.6789;

numObj.toFixed();       // Renvoie '12346' : arrondi, aucune partie fractionnaire
numObj.toFixed(1);      // Renvoie '12345.7' : arrondi ici aussi
numObj.toFixed(6);      // Renvoie '12345.678900' : des zéros sont ajoutés
(1.23e+20).toFixed(2);  // Renvoie '123000000000000000000.00'
(1.23e-10).toFixed(2);  // Renvoie '0.00'
2.34.toFixed(1);        // Renvoie '2.3'
-2.34.toFixed(1);       // Renvoie -2.3 (en raison de la précédence des opérateurs, 
                        // les littéraux de nombres négatifs ne renvoient pas de chaînes)
2.35.toFixed(1);        // Renvoie '2.4' (arrondi supérieur)
(-2.34).toFixed(1);     // Renvoie '-2.3' (... sauf si on a des parenthèses)

Spécifications

Spécification État Commentaires
ECMAScript 3rd Edition (ECMA-262) Standard Définition initiale. Implémentée avec JavaScript 1.5.
ECMAScript 5.1 (ECMA-262)
La définition de 'Number.prototype.toFixed' dans cette spécification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Number.prototype.toFixed' dans cette spécification.
Standard  
ECMAScript 2017 Draft (ECMA-262)
La définition de 'Number.prototype.toFixed' dans cette spécification.
Projet  

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple (Oui) (Oui) (Oui) (Oui) (Oui)
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple (Oui) (Oui) (Oui) (Oui) (Oui) (Oui)

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight, forresst
 Dernière mise à jour par : SphinxKnight,