CKTIS / JavaScript
Math.round: dichtstbijzijnde geheel getal
Math.round converteert het argument naar Number en geeft de dichtstbijzijnde integrale Number, met gelijke afstand richting +Infinity.
Versie: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntax
Math.round(x)Math.round(x) past ToNumber toe. Zijn twee gehele waarden even dichtbij, dan kiest het die dichter bij +Infinity: 2.5 wordt 3, maar -2.5 wordt -2. Een al integraal argument, NaN, +Infinity, -Infinity, +0 of -0 wordt met behoud van die speciale waarde teruggegeven.
Van -0.5 inclusief tot 0 exclusief is het resultaat -0, detecteerbaar met Object.is of het omgekeerde. Daarom is Math.round(x) niet altijd gelijk aan Math.floor(x + 0.5), dat het nulteken kan verliezen; de optelling kan ook een zeer grote x afronden.
Een numerieke tekenreeks wordt geconverteerd, een ontbrekend argument geeft NaN, en Symbol of BigInt werpt TypeError. De functie bestaat sinds ECMAScript 1 en is geen constructor. Ze rondt waarden af en formatteert geen tekst; behandel decimale presentatie en binary64-afronding apart.
Voorbeelden
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); }Resultaat
2,3,-2,-3 true true 5 Infinity true true true
Math.round → ties toward +Infinity and preserved -0