Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Math.round: inteiro mais próximo

Math.round converte o argumento para Number e devolve o Number inteiro mais próximo, resolvendo empates para +Infinity.

Versão: ECMAScript 1 onward; example target: Node.js 24.22.2

Sintaxe

Math.round(x)

Math.round(x) aplica ToNumber. Se dois inteiros estiverem igualmente próximos, escolhe o mais perto de +Infinity: 2.5 dá 3, mas -2.5 dá -2. Um argumento já inteiro, NaN, +Infinity, -Infinity, +0 ou -0 é devolvido preservando esse valor especial.

De -0.5 inclusive até 0 exclusivo, o resultado é -0, detetável com Object.is ou o recíproco. Assim, Math.round(x) nem sempre equivale a Math.floor(x + 0.5), que pode perder o sinal do zero; a soma pode ainda arredondar um x muito grande.

Uma string numérica é convertida, a ausência de argumento dá NaN, e Symbol ou BigInt lança TypeError. A função existe desde ECMAScript 1 e não é construtor. Arredonda valores, não formata texto; trata separadamente a apresentação decimal e o arredondamento binary64.

Exemplos

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); }

Resultado

2,3,-2,-3
true true
5 Infinity
true true
true

Math.round → ties toward +Infinity and preserved -0

Fontes