CKTIS / JavaScript
Number.prototype.toPrecision: platné číslice
toPrecision vracia text s požadovaným počtom platných číslic v pevnom alebo exponenciálnom zápise.
Verzia: ECMAScript 3 onward; example target: Node.js 24.22.2
Syntax
number.toPrecision(precision)number.toPrecision(precision) formátuje hodnotu s precision platnými číslicami. Ak je argument vynechaný alebo je undefined, metóda ihneď vráti bežný výsledok ToString čísla. Zadaný argument prejde ToIntegerOrInfinity: zlomok sa oreže k nule a NaN sa zmení na 0; pri konečnom prijímači výsledok mimo 1..100 vyvolá RangeError.
Po prevode zadaného argumentu vráti prijímač NaN alebo ±Infinity bežný text ešte pred kontrolou rozsahu, takže Infinity.toPrecision(0) dá "Infinity". Objekt odovzdaný ako precision však môže pri prevode vyvolať výnimku. Pre konečnú hodnotu sa exponenciálny zápis použije, ak je desatinný exponent menší než -6 alebo aspoň precision; inak pevný zápis. Zaokrúhľuje sa k najbližšiemu výsledku a pri zhode po oddelení znamienka k väčšej veľkosti.
Metóda existuje od ECMAScript 3, nie je všeobecná a pre iný prijímač než Number či zabalený Number vyvolá TypeError. Vracia text, nie číslo. Number má binárnu reprezentáciu, takže zaokrúhlenie môže prekvapiť; na miestne zobrazenie použi Intl.NumberFormat.
Príklady
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); }Výsledok
1235 1.23e+3 0.00000123 1.23e-7 7 0.00 Infinity RangeError TypeError
Príklad porovnáva pevný a exponenciálny zápis a ukazuje -0, Infinity a chyby rozsahu/prijímača.