CKTIS / JavaScript
Number.prototype.toPrecision: značilne števke
toPrecision vrne besedilo z zahtevanim številom značilnih števk v stalnem ali eksponentnem zapisu.
Različica: ECMAScript 3 onward; example target: Node.js 24.22.2
Sintaksa
number.toPrecision(precision)number.toPrecision(precision) oblikuje vrednost s precision značilnimi števkami. Če je argument izpuščen ali undefined, metoda takoj vrne običajni rezultat ToString števila. Podani argument gre skozi ToIntegerOrInfinity: ulomek se odreže proti nič in NaN postane 0; pri končnem prejemniku rezultat zunaj 1..100 sproži RangeError.
Po pretvorbi podanega argumenta prejemnik NaN ali ±Infinity vrne običajno besedilo pred preverjanjem območja, zato Infinity.toPrecision(0) da "Infinity". Objekt, podan kot precision, lahko med pretvorbo vseeno sproži izjemo. Za končno vrednost se eksponentni zapis uporabi, če je decimalni eksponent manjši od -6 ali vsaj precision; sicer stalni zapis. Zaokroži se k najbližjemu rezultatu in ob izenačenju po ločitvi predznaka k večji velikosti.
Metoda obstaja od ECMAScript 3, ni generična in pri prejemniku, ki ni Number ali oviti Number, sproži TypeError. Vrne besedilo, ne števila. Number je binaren, zato lahko zaokroževanje preseneti; za lokalni prikaz uporabi Intl.NumberFormat.
Primeri
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); }Rezultat
1235 1.23e+3 0.00000123 1.23e-7 7 0.00 Infinity RangeError TypeError
Primer primerja stalni in eksponentni zapis ter pokaže -0, Infinity in napake območja/prejemnika.