WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen