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.

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 AndroidFirefox für AndroidOpera für AndroidSafari auf iOSSamsung InternetNode.js
toPrecisionChrome Vollständige Unterstützung 1Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 1IE Vollständige Unterstützung 5.5Opera Vollständige Unterstützung JaSafari Vollständige Unterstützung JaWebView Android Vollständige Unterstützung 1Chrome Android Vollständige Unterstützung 18Firefox Android Vollständige Unterstützung 4Opera Android Vollständige Unterstützung JaSafari iOS Vollständige Unterstützung JaSamsung Internet Android Vollständige Unterstützung 1.0nodejs Vollständige Unterstützung Ja

Legende

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

Siehe auch

Verwandte Themen
  1. Standard-Objekte
  2. Number
  3. Eigenschaften
    1. Number.EPSILON
    2. Number.MAX_SAFE_INTEGER
    3. Number.MAX_VALUE
    4. Number.MIN_SAFE_INTEGER
    5. Number.MIN_VALUE
    6. Number.NEGATIVE_INFINITY
    7. Number.NaN
    8. Number.POSITIVE_INFINITY
    9. Number.prototype
  4. Methoden
    1. Number.isFinite()
    2. Number.isInteger()
    3. Number.isNaN()
    4. Number.isSafeInteger()
    5. Number.parseFloat()
    6. Number.parseInt()
    7. Number.prototype.toExponential()
    8. Number.prototype.toFixed()
    9. Number.prototype.toLocaleString()
    10. Number.prototype.toPrecision()
    11. Number.prototype.toSource()
    12. Number.prototype.toString()
    13. Number.prototype.valueOf()
    14. Number.toInteger()
  5. Vererbung:
  6. Function
  7. Eigenschaften
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.name
    7. Function.prototype
  8. Methoden
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()
  9. Object
  10. Eigenschaften
    1. Object.prototype.__count__ [Übersetzen]
    2. Object.prototype.__noSuchMethod__ [Übersetzen]
    3. Object.prototype.__parent__ [Übersetzen]
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  11. Methoden
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__() [Übersetzen]
    3. Object.prototype.__lookupGetter__() [Übersetzen]
    4. Object.prototype.__lookupSetter__() [Übersetzen]
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf() [Übersetzen]
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString() [Übersetzen]
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.unwatch() [Übersetzen]
    12. Object.prototype.valueOf()
    13. Object.prototype.watch() [Übersetzen]
    14. Object.setPrototypeOf() [Übersetzen]