Number.prototype.toPrecision()

Die toPrecision() Methode gibt einen String zurück, der ein Number Objekt mit einer spezifizierten Präzision repräsentiert.

Syntax

numObj.toPrecision([precision])

Parameter

precision: Optional. Eine ganze Zahl, die die signifikanten Ziffern der Zahl angibt.

Ein string, der ein Number Objekt in Fließkomma- oder Exponentialdarstellung auf die in precision angegeben Stellen gerundet zurück gibt. Weitere Informationen zum runden in dieser Methode sind in der Beschreibung von Number.prototype.toFixed() zu finden, die auch auf toPrecision() zutreffen.

Wenn kein precision Argument angegeben wird, ist die rückgabe wie in der Number.prototype.toString() Methode. Wenn die precision keine ganze Zahl ist, wird zu der am nächst liegenden ganzen Zahl gerundet.

Auftretende Fehler

RangeError (en-US): Wenn precison keine Zahl zwischen 1 und 100 (inklusiv) ist, tritt ein RangeError auf. Es gibt implementierungen die mehr und weniger signifikante Stellen zulassen. ECMA-262 spezifiziert nur eine Präzision von 21 signifikanten Stellen.

Beispiele

Einsatz von `toPrecision`

var numObj = 5.123456;

console.log(numObj.toPrecision());    // Ausgabe: 5.123456
console.log(numObj.toPrecision(5));   // Ausgabe: 5.1235
console.log(numObj.toPrecision(2));   // Ausgabe: 5.1
console.log(numObj.toPrecision(1));   // Ausgabe: 5

numObj = 0.000123

console.log(numObj.toPrecision());    // logs 0.000123
console.log(numObj.toPrecision(5));   // logs 0.00012300
console.log(numObj.toPrecision(2));   // logs 0.00012
console.log(numObj.toPrecision(1));   // logs 0.0001

// In manchen Fällen wird die Exponentialdarstellung ausgegeben.
console.log((1234.5).toPrecision(2)); // Ausgabe: 1.2e+3

Spezifikationen

Spezifikation	Status	Kommentar
ECMAScript 3rd Edition (ECMA-262)	Standard	Initiale Definition. Implementiert in JavaScript 1.5.
ECMAScript 5.1 (ECMA-262) Die Definition von 'Number.prototype.toPrecision' in dieser Spezifikation.	Standard
ECMAScript 2015 (6th Edition, ECMA-262) Die Definition von 'Number.prototype.toPrecision' in dieser Spezifikation.	Standard
ECMAScript (ECMA-262) Die Definition von 'Number.prototype.toPrecision' in dieser Spezifikation.	Lebender Standard

Browserkompatibilität

BCD tables only load in the browser