WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Number.prototype.toPrecision: signifikante Stellen

toPrecision liefert Text mit der verlangten Zahl signifikanter Stellen und wählt Fest- oder Exponentialschreibweise.

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

Syntax

number.toPrecision(precision)

number.toPrecision(precision) formatiert den Wert mit precision signifikanten Stellen. Fehlt das Argument oder ist es undefined, liefert die Methode sofort das gewöhnliche ToString-Ergebnis der Zahl. Ein angegebenes Argument durchläuft ToIntegerOrInfinity: Ein Bruchteil wird gegen null abgeschnitten und NaN wird 0; bei endlichem Empfänger wirft ein Ergebnis außerhalb 1..100 RangeError.

Nach der Konvertierung eines angegebenen Arguments liefert ein Empfänger NaN oder ±Infinity seinen gewöhnlichen Text noch vor der Bereichsprüfung; daher ergibt Infinity.toPrecision(0) "Infinity". Ein als precision übergebenes Objekt kann dennoch bei der Konvertierung werfen. Für einen endlichen Wert wird Exponentialschreibweise benutzt, wenn der Dezimalexponent kleiner als -6 oder mindestens precision ist, sonst Festschreibweise. Gerundet wird zum nächsten Ergebnis, bei Gleichstand nach Trennung des Vorzeichens zum größeren Betrag.

Die Methode existiert seit ECMAScript 3, ist nicht generisch und wirft bei einem anderen Empfänger als Number oder Number-Objekt TypeError. Sie liefert Text, keine Zahl. Number ist binär dargestellt, daher kann Rundung überraschen; für lokale Darstellung dient Intl.NumberFormat.

Beispiele

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); }

Ergebnis

1235 1.23e+3
0.00000123 1.23e-7
7 0.00
Infinity
RangeError
TypeError

Das Beispiel vergleicht Fest- und Exponentialschreibweise und zeigt -0, Infinity sowie Bereichs-/Empfängerfehler.

Quellen