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