Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Math.round: nejbližší celé číslo

Math.round převede argument na Number a vrátí nejbližší celočíselný Number, přičemž shodu řeší směrem k +Infinity.

Verze: ECMAScript 1 onward; example target: Node.js 24.22.2

Syntaxe

Math.round(x)

Math.round(x) použije ToNumber. Jsou-li dvě celá čísla stejně blízko, zvolí bližší k +Infinity: 2.5 dá 3, ale -2.5 dá -2. Již celočíselný argument, NaN, +Infinity, -Infinity, +0 či -0 vrátí se zachováním zvláštní hodnoty.

Od -0.5 včetně do 0 bez nuly je výsledkem -0, zjistitelná přes Object.is či převrácenou hodnotu. Proto Math.round(x) není vždy totéž jako Math.floor(x + 0.5), které může ztratit znaménko nuly; sčítání může též zaokrouhlit velmi velké x.

Číselný řetězec se převede, chybějící argument dá NaN a Symbol či BigInt vyvolá TypeError. Funkce existuje od ECMAScript 1 a není konstruktor. Zaokrouhluje hodnotu, neformátuje text; desetinné zobrazení řešte zvlášť s ohledem na binary64.

Příklady

console.log([2.3, 2.5, -2.5, -2.6].map(Math.round).join(","));
console.log(Object.is(Math.round(-0.5), -0), Object.is(Math.round(-0.1), -0));
console.log(Math.round("4.6"), Math.round(Infinity));
console.log(Number.isNaN(Math.round()), Object.is(Math.round(-0), -0));
try { Math.round(3n); } catch (error) { console.log(error instanceof TypeError); }

Výsledek

2,3,-2,-3
true true
5 Infinity
true true
true

Math.round → ties toward +Infinity and preserved -0

Zdroje