CKTIS / JavaScript
Math.trunc: parte inteira em direção a zero
Math.trunc converte o argumento para Number e remove a parte fracionária, arredondando em direção a zero.
Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaxe
Math.trunc(x)Math.trunc(x) aplica ToNumber e devolve a parte inteira de x finito: 3.9 torna-se 3 e -3.9 torna-se -3. Se o Number já for inteiro, é devolvido sem alteração, incluindo a preservação de +0 e -0. O resultado continua a ser Number, por isso não ganha precisão arbitrária.
NaN e a ausência de argumento dão NaN, enquanto Infinity e -Infinity são devolvidos sem alteração. Uma string numérica é convertida; Symbol ou BigInt lança TypeError, e a conversão de um objeto pode executar código do utilizador. Uma fração negativa entre -1 e 0 produz -0, detetável com Object.is; a entrada já é um valor binary64 arredondado antes do truncamento.
O método existe desde ECMAScript 2015 e não é construtor. O exemplo converte 9876 milissegundos em 9 segundos inteiros e demonstra a conversão e -0. Não substituas o truncamento de números por parseInt nem por operações bit a bit que convertem para 32 bits; para inteiros grandes exatos usa aritmética BigInt adequada em vez de Math.trunc.
Exemplos
const milliseconds = 9876;
console.log(Math.trunc(milliseconds / 1000));
console.log(Math.trunc(3.9), Math.trunc(-3.9));
console.log(Object.is(Math.trunc(-0.25), -0));
console.log(Math.trunc("12.8"));
try { Math.trunc(1n); } catch (error) { console.log(error instanceof TypeError); }Resultado
9 3 -3 true 12 true
Math.trunc → segundos inteiros, conversão de string, zero negativo e TypeError para BigInt