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

CKTIS / JavaScript

Math.ceil: arredondamento para cima

Math.ceil converte o argumento para Number e devolve o menor valor numérico inteiro que não é inferior à entrada.

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

Sintaxe

Math.ceil(x)

Math.ceil(x) aplica ToNumber e arredonda para +Infinity. ceil(4.01) é 5 e ceil(-4.99) é -4. Um inteiro e ±Infinity não mudam, NaN dá NaN. Para valor negativo entre -1 e 0, o resultado é -0, cujo sinal pode importar depois.

Uma string numérica funciona, null torna-se 0 e sem argumento dá NaN. Symbol ou BigInt lança TypeError; um objeto pode executar valueOf ou toString. O resultado continua Number e não recupera dígitos perdidos pela precisão IEEE 754.

Não é construtor e é padrão desde ECMAScript 1. Útil para Math.ceil(total / pageSize) ou unidades completas necessárias. Difere de floor nos negativos, de trunc na direção e de round nas metades. Valide tamanho positivo não nulo antes de dividir.

Exemplos

const totalItems = 101;
const pageSize = 20;
console.log(Math.ceil(totalItems / pageSize));
console.log(Math.ceil(4.01), Math.ceil(-4.99));
console.log(Object.is(Math.ceil(-0.25), -0));
console.log(Math.ceil("3.2"), Math.ceil(null));
console.log(Number.isNaN(Math.ceil()), Math.ceil(Infinity));
try { Math.ceil(1n); } catch (error) { console.log(error instanceof TypeError); }

Resultado

6
5 -4
true
4 0
true Infinity
true

Fontes