CKTIS / JavaScript
Math.round: najbližšie celé číslo
Math.round prevedie argument na Number a vráti najbližší celočíselný Number, pričom zhodu rieši smerom k +Infinity.
Verzia: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntax
Math.round(x)Math.round(x) použije ToNumber. Ak sú dve celé čísla rovnako blízko, zvolí bližšie k +Infinity: 2.5 dá 3, ale -2.5 dá -2. Už celočíselný argument, NaN, +Infinity, -Infinity, +0 či -0 vráti so zachovaním osobitnej hodnoty.
Od -0.5 vrátane do 0 bez nuly je výsledkom -0, zistiteľná cez Object.is či prevrátenú hodnotu. Preto Math.round(x) nie je vždy to isté ako Math.floor(x + 0.5), ktoré môže stratiť znamienko nuly; sčítanie môže tiež zaokrúhliť veľmi veľké x.
Číselný reťazec sa prevedie, chýbajúci argument dá NaN a Symbol či BigInt vyvolá TypeError. Funkcia existuje od ECMAScript 1 a nie je konštruktor. Zaokrúhľuje hodnotu, neformátuje text; desatinné zobrazenie riešte zvlášť s ohľadom na binary64.
Prí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ýsledok
2,3,-2,-3 true true 5 Infinity true true true
Math.round → ties toward +Infinity and preserved -0