Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje