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.

Rückgabewert

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
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 Latest Draft (ECMA-262)
Die Definition von 'Number.prototype.toPrecision' in dieser Spezifikation.
Entwurf  

Browserkompatibilität

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidEdge MobileFirefox für AndroidOpera für AndroidiOS SafariSamsung InternetNode.js
Grundlegende UnterstützungChrome Vollständige Unterstützung JaEdge Vollständige Unterstützung JaFirefox Vollständige Unterstützung 1IE Vollständige Unterstützung JaOpera Vollständige Unterstützung JaSafari Vollständige Unterstützung JaWebView Android Vollständige Unterstützung JaChrome Android Vollständige Unterstützung JaEdge Mobile Vollständige Unterstützung JaFirefox Android Vollständige Unterstützung 4Opera Android Vollständige Unterstützung JaSafari iOS Vollständige Unterstützung JaSamsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung Ja

Legende

Vollständige Unterstützung  
Vollständige Unterstützung

Siehe auch

Schlagwörter des Dokuments und Mitwirkende

Schlagwörter: 
Mitwirkende an dieser Seite: schlagi123, phax
Zuletzt aktualisiert von: schlagi123,