SUBSTITUTE
Aplica-se a:
Coluna calculadaTabela calculadaMedidaCálculo visual
Substitui o texto original pelo novo texto em uma cadeia de texto.
Sintaxe
SUBSTITUTE(<text>, <old_text>, <new_text>, <instance_num>)
Parâmetros
| Termo | Definição |
|---|---|
| texto | O texto em que você deseja substituir caracteres ou uma referência a uma coluna contendo texto. |
| old_text | O texto original que você deseja substituir. |
| new_text | O texto que você deseja inserir no lugar de old_text. |
| instance_num | (Opcional) A ocorrência de old_text que você deseja substituir. Se omitido, todas as instâncias de old_text serão substituídas |
Retornar valor
Uma cadeia de texto.
Comentários
Use a função SUBSTITUTE quando desejar substituir um texto específico em uma cadeia de texto; e use a função REPLACE quando desejar substituir qualquer texto de comprimento variável que ocorra em uma localização específica de uma cadeia de texto.
A função SUBSTITUTE diferencia maiúsculas de minúsculas. Se não houver uma correspondência exata das configurações de maiúsculas e minúsculas entre text e old_text, a função SUBSTITUTE não substituirá o texto.
Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.
Exemplo: substituição dentro de uma cadeia de caracteres
A fórmula a seguir cria uma cópia da coluna [Product Code] que substitui o novo código do produto NW pelo código de produto antigo PA onde quer que ele ocorra na coluna.
= SUBSTITUTE([Product Code], "NW", "PA")