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

CKTIS / JavaScript

Math.floor: arredondamento para baixo

Math.floor converte o argumento para Number e devolve o maior valor numérico inteiro que não excede a entrada.

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

Sintaxe

Math.floor(x)

Math.floor(x) aplica ToNumber e arredonda para -Infinity. floor(7.9) é 7 e floor(-7.1) é -8. Um inteiro e ±Infinity não mudam, NaN dá NaN. floor(-0) preserva -0, enquanto todo número finito entre -1 e 0 dá -1.

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

Não é construtor e é padrão desde ECMAScript 1. Útil para Math.floor(timestamp / windowMs). Com dados negativos, não substitua cegamente por Math.trunc: trunca para zero e escolhe outro intervalo. Valide tamanho positivo não nulo.

Exemplos

const windowMs = 1000;
const timestamps = [1999, 2000, -1];
console.log(timestamps.map((value) => Math.floor(value / windowMs)).join(","));
console.log(Math.floor(7.9), Math.floor(-7.1));
console.log(Object.is(Math.floor(-0), -0), Math.floor(-0.25));
console.log(Math.floor("3.9"), Math.floor(null));
console.log(Number.isNaN(Math.floor()), Math.floor(-Infinity));
try { Math.floor(1n); } catch (error) { console.log(error instanceof TypeError); }

Resultado

1,2,-1
7 -8
true -1
3 0
true -Infinity
true

Fontes