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