CKTIS / JavaScript
Number.prototype.toPrecision: significante cijfers
toPrecision geeft tekst met het gevraagde aantal significante cijfers in vaste of exponentiële notatie.
Versie: ECMAScript 3 onward; example target: Node.js 24.22.2
Syntax
number.toPrecision(precision)number.toPrecision(precision) formatteert de waarde met precision significante cijfers. Als het argument ontbreekt of undefined is, geeft de methode onmiddellijk het gewone ToString-resultaat van het getal. Een opgegeven argument ondergaat ToIntegerOrInfinity: een breuk wordt naar nul afgekapt en NaN wordt 0; bij een eindige ontvanger werpt een resultaat buiten 1..100 RangeError.
Na omzetting van een opgegeven argument geeft een ontvanger NaN of ±Infinity zijn gewone tekst vóór de bereikcontrole; Infinity.toPrecision(0) geeft dus "Infinity". Een object als precision kan tijdens omzetting toch werpen. Voor een eindige waarde wordt exponentiële notatie gebruikt als de decimale exponent kleiner is dan -6 of minstens precision; anders vaste notatie. Er wordt afgerond naar het dichtstbijzijnde resultaat en bij gelijkstand na afscheiding van het teken naar de grotere grootte.
De methode bestaat sinds ECMAScript 3, is niet generiek en werpt TypeError voor iets anders dan een Number of boxed Number. Ze geeft tekst, geen getal. Number is binair, zodat afronding kan verrassen; gebruik Intl.NumberFormat voor lokale presentatie.
Voorbeelden
console.log((1234.5).toPrecision(4), (1234.5).toPrecision(3));
console.log((0.0000012345).toPrecision(3), (0.00000012345).toPrecision(3));
console.log((7).toPrecision(), (-0).toPrecision(3));
console.log(Infinity.toPrecision(0));
try { console.log((1).toPrecision(0)); } catch (error) { console.log(error.name); }
try { Number.prototype.toPrecision.call("1", 2); } catch (error) { console.log(error.name); }Resultaat
1235 1.23e+3 0.00000123 1.23e-7 7 0.00 Infinity RangeError TypeError
Het voorbeeld vergelijkt vaste en exponentiële notatie en toont -0, Infinity en bereik-/ontvangerfouten.