[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/Number/toPrecision [Back]  [Original]

Number.prototype.toPrecision() - JavaScript | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

Number.prototype.toPrecision()

Baseline Large disponibilit

Cette fonctionnalit est bien tablie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La mthode toPrecision() renvoie une chane de caractres reprsentant un nombre avec la prcision donne.

Dans cet article

Exemple interactif

function precise(x) {
  return x.toPrecision(4);
}

console.log(precise(123.456));
// Expected output: "123.5"

console.log(precise(0.004));
// Expected output: "0.004000"

console.log(precise(1.23e5));
// Expected output: "1.230e+5"

Syntaxe

js
numObj.toPrecision([prcision]);

Paramtre

prcision

Paramtre optionnel. Un entier spcifiant le nombre de chiffres significatifs.

Valeur de retour

Cette mthode renvoie une chane de caractres reprsentant l'objet Number en notation point fixe ou en notation exponentielle, arrondi avec un nombre de chiffres significatifs gal prcision. Le principe utilis pour les arrondis est celui dcrit dans la page de la mthode Number.prototype.toFixed().

Si l'argument prcision n'est pas utilis, la mthode aura le mme 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 prcison n'est pas compris, au sens large, entre 1 et 100, on aura une exception RangeError. Les implmentations peuvent supporter des valeurs suprieures et/ou infrieures. Le standard ECMA-262 ne ncessite qu'une prcision allant jusqu' 21 chiffres significatifs.

Exemples

js
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"

Spcifications

Spcification
ECMAScript 2027 LanguageSpecification
# sec-number.prototype.toprecision

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page