Número → texto (padrão pt-BR).
| Campo | Valor |
|---|---|
| Categoria | Texto |
| 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: TEXTO. Aliases aceitos (maiúsc./minúsc. indiferente): format.
Assinatura#
code
TEXTO(expr; [arg2])Todos os argumentos são expressões.
Retorno#
Texto.
Tratamento de nulos#
O vazio vira texto vazio ("").
Contexto de avaliação#
Escalar — avaliada sobre o resultado dos argumentos (nas colunas calculadas, roda linha a linha).
Diferenças para DAX#
- Equivalente DAX: FORMAT
- Compatibilidade: DIFERE do DAX — semântica diferente, atenção
- Observação: NÃO é uma string de formato: o 2º argumento é o número de casas decimais (padrão pt-BR). Para formatação rica use as opções de formato do campo.
Exemplos#
code
TEXTO(receita; 2)Exemplo com valores#
Entrada: número 1234,5 com 2 casas.
code
TEXTO(1234,5; 2) → "1.234,50"Resultado esperado: "1.234,50"
Exemplo de negócio#
Formatar a receita com 2 casas para o rótulo do dado.
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.