CKTIS / JavaScript
Math.round: nächste Ganzzahl
Math.round wandelt das Argument in Number um und liefert die nächste ganzzahlige Number; Gleichstände gehen zu +Infinity.
Version: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntax
Math.round(x)Math.round(x) wendet ToNumber an. Sind zwei Ganzzahlen gleich nah, wird die nähere an +Infinity gewählt: 2.5 wird 3, aber -2.5 wird -2. Ein bereits ganzzahliges Argument, NaN, +Infinity, -Infinity, +0 oder -0 wird unter Erhalt dieses Sonderwerts zurückgegeben.
Für Werte von einschließlich -0.5 bis ausschließlich 0 ist das Ergebnis -0; erkennbar mit Object.is oder dem Kehrwert. Daher ist Math.round(x) nicht immer gleich Math.floor(x + 0.5): Letzteres kann das Nullvorzeichen verlieren, und die Addition kann sehr großes x bereits runden.
Eine numerische Zeichenkette wird umgewandelt, ein fehlendes Argument ergibt NaN, Symbol oder BigInt löst TypeError aus. Die Funktion existiert seit ECMAScript 1 und ist kein Konstruktor. Sie rundet Zahlen, formatiert aber keinen Text; Dezimalstellen separat formatieren und binary64-Rundung beachten.
Beispiele
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); }Ergebnis
2,3,-2,-3 true true 5 Infinity true true true
Math.round → ties toward +Infinity and preserved -0