Number.prototype.toPrecision()
La méthode toPrecision()
renvoie une chaîne de caractères représentant un nombre avec la précision donnée.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
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.
Exemples
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 (ECMA-262) La définition de 'Number.prototype.toPrecision' dans cette spécification. |
Standard évolutif |
Compatibilité des navigateurs
BCD tables only load in the browser
Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une pull request sur https://github.com/mdn/browser-compat-data.