Troca todas as ocorrências de um trecho.
| Campo | Valor |
|---|---|
| Categoria | Texto |
| Tipo | Escalar (opera valor a valor) |
| Aridade | 3 argumentos (fixo) |
| Compila para SQL (coluna calculada) | Sim |
| Versão | Motor de fórmulas v3. |
Aliases#
Nome canônico: SUBSTITUIR. Aliases aceitos (maiúsc./minúsc. indiferente): substitute, replace.
Assinatura#
código
SUBSTITUIR(expr; arg2; arg3)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: SUBSTITUTE
- Compatibilidade: DIFERE do DAX — semântica diferente, atenção
- Observação: Troca TODAS as ocorrências por conteúdo (como SUBSTITUTE). O alias
replaceNÃO é o REPLACE por posição do DAX/Excel.
Exemplos#
código
SUBSTITUIR(sku; "-"; "")Exemplo com valores#
Entrada: "A-B-C", troca "-" por "".
código
SUBSTITUIR("A-B-C"; "-"; "") → "ABC"Resultado esperado: "ABC"
Exemplo de negócio#
Limpar o SKU tirando hífens antes de cruzar com outra base.
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.