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

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

Fontes