CKTIS / JavaScript
Number.prototype.toPrecision: platné číslice
toPrecision vrací text s požadovaným počtem platných číslic v pevné nebo exponenciální notaci.
Verze: ECMAScript 3 onward; example target: Node.js 24.22.2
Syntaxe
number.toPrecision(precision)number.toPrecision(precision) formátuje hodnotu s precision platnými číslicemi. Je-li argument vynechán nebo je undefined, metoda ihned vrátí běžný výsledek ToString čísla. Zadaný argument projde ToIntegerOrInfinity: zlomek se ořízne k nule a NaN se změní na 0; u konečného přijímače výsledek mimo 1..100 vyvolá RangeError.
Po převodu zadaného argumentu vrátí přijímač NaN nebo ±Infinity běžný text ještě před kontrolou rozsahu, takže Infinity.toPrecision(0) dá "Infinity". Objekt předaný jako precision však může při převodu vyvolat výjimku. Pro konečnou hodnotu se exponenciální zápis použije, je-li desetinný exponent menší než -6 nebo alespoň precision; jinak pevný zápis. Zaokrouhluje se k nejbližšímu výsledku a při shodě po oddělení znaménka k větší velikosti.
Metoda existuje od ECMAScript 3, není obecná a pro jiný přijímač než Number či zabalený Number vyvolá TypeError. Vrací text, ne číslo. Number má binární reprezentaci, takže zaokrouhlení může překvapit; pro místní zobrazení použij Intl.NumberFormat.
Pří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ýsledek
1235 1.23e+3 0.00000123 1.23e-7 7 0.00 Infinity RangeError TypeError
Příklad porovnává pevný a exponenciální zápis a ukazuje -0, Infinity a chyby rozsahu/přijímače.