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