Corta as casas decimais (não arredonda).
| Campo | Valor |
|---|---|
| Categoria | Matemática |
| Tipo | Escalar (opera valor a valor) |
| Aridade | 1 a 2 argumentos |
| Compila para SQL (coluna calculada) | Sim |
| Versão | Motor de fórmulas v3. |
Aliases#
Nome canônico: TRUNCAR. Aliases aceitos (maiúsc./minúsc. indiferente): trunc.
Assinatura#
código
TRUNCAR(expr; [arg2])Todos os argumentos são expressões.
Retorno#
Número.
Tratamento de nulos#
Texto que não é número, ou valor vazio numa conta, viram erro amigável (pt-BR) — nunca zero silencioso.
Contexto de avaliação#
Escalar — avaliada sobre o resultado dos argumentos (nas colunas calculadas, roda linha a linha).
Diferenças para DAX#
- Equivalente DAX: TRUNC
- Compatibilidade: Compatível com DAX
- Observação: Corta casas decimais sem arredondar.
Exemplos#
código
TRUNCAR(9,99; 1)Exemplo com valores#
Entrada: 9,99 com 1 casa.
código
TRUNCAR(9,99; 1) → 9,9Resultado esperado: 9,9
Exemplo de negócio#
Normalizar números financeiros — arredondar preços, tirar o sinal de um desvio, calcular potências/raízes.
Erros comuns#
Erros de digitação em nome de coluna, tipo incompatível ou argumento inválido viram mensagem amigável (pt-BR) — o motor nunca devolve um número errado em silêncio.