Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje