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

CKTIS / JavaScript

Number.prototype.toExponential: exponenciální zápis

toExponential vrací exponenciální text s jednou číslicí před tečkou a požadovaným počtem za ní.

Verze: ECMAScript 3 onward; example target: Node.js 24.22.2

Syntaxe

number.toExponential(fractionDigits)

number.toExponential(fractionDigits) formátuje Number jako desetinný text s malým e, výslovným znaménkem exponentu a jednou číslicí před tečkou. Je-li fractionDigits undefined, vybere nejkratší posloupnost jednoznačně určující Number. Je-li zadán, výsledek má přesně tolik číslic za tečkou.

Argument projde ToIntegerOrInfinity: zlomky se oříznou k nule a NaN se změní na 0. Pro konečný přijímač je rozsah 0..100; hodnoty mimo něj a ±Infinity vyvolají RangeError. Argument se však převádí první a nekonečný či NaN přijímač pak vrátí text před kontrolou rozsahu, takže Infinity.toExponential(101) dá "Infinity"; objekt argumentu může při převodu přesto vyvolat výjimku.

Metoda existuje od ECMAScript 3, není obecná a pro jiný přijímač než Number či zabalený Number vyvolá TypeError. Zaokrouhluje k nejbližšímu matematickému výsledku a při shodě po oddělení znaménka volí větší velikost; binární reprezentace může překvapit. Záporná nula se vypíše bez mínusu.

Příklady

console.log((1234.5).toExponential(2), (0.00125).toExponential(2));
console.log((7).toExponential(), (-0).toExponential(1));
console.log(Infinity.toExponential(101));
try { console.log((1).toExponential(101)); } catch (error) { console.log(error.name); }
try { Number.prototype.toExponential.call("1", 2); } catch (error) { console.log(error.name); }

Výsledek

1.23e+3 1.25e-3
7e+0 0.0e+0
Infinity
RangeError
TypeError

Příklad ukazuje pevný počet číslic, vynechaný argument, -0 a pořadí Infinity vůči RangeError.

Zdroje