Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri