La méthode toPrecision()
renvoie une chaîne de caractères représentant un nombre avec la précision donnée.
Syntaxe
numObj.toPrecision([précision])
Paramètre
précision
- Paramètre optionnel. Un entier spécifiant le nombre de chiffres significatifs.
Valeur de retour
Cette méthode renvoie une chaîne de caractères représentant l'objet Number
en notation à point fixe ou en notation exponentielle, arrondi avec un nombre de chiffres significatifs égal à précision
. Le principe utilisé pour les arrondis est celui décrit dans la page de la méthode Number.prototype.toFixed()
.
Si l'argument précision
n'est pas utilisé, la méthode aura le même effet que Number.prototype.toString()
. Si cet argument n'est pas un nombre entier, on prendra le nombre entier le plus proche.
Exceptions
RangeError
- Si
précison
n'est pas compris, au sens large, entre 1 et 100, on aura une exceptionRangeError
. Les implémentations peuvent supporter des valeurs supérieures et/ou inférieures. Le standard ECMA-262 ne nécessite qu'une précision allant jusqu'à 21 chiffres significatifs.
Exemple
var objetNumber = 5.123456; console.log(objetNumber.toPrecision()); //affiche 5.123456 console.log(objetNumber.toPrecision(5)); //affiche 5.1235 console.log(objetNumber.toPrecision(2)); //affiche 5.1 console.log(objetNumber.toPrecision(1)); //affiche 5 numObj = 0.000123; console.log(numObj.toPrecision()); // affiche 0.000123 console.log(numObj.toPrecision(5)); // affiche 0.00012300 console.log(numObj.toPrecision(2)); // affiche 0.00012 console.log(numObj.toPrecision(1)); // affiche 0.0001 // dans certaines circonstances, on peut avoir une notation exponentielle console.log((1234.5).toPrecision(2)); // "1.2e+3"
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.toPrecision' dans cette spécification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'Number.prototype.toPrecision' dans cette spécification. |
Standard | |
ECMAScript 2017 Draft (ECMA-262) La définition de 'Number.prototype.toPrecision' 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
Étiquettes :
Contributeurs à cette page :
SphinxKnight
Dernière mise à jour par :
SphinxKnight,