MEMBRO SUPLENTE
Aplica-se a: Coluna calculada Tabela calculada Medida Cálculo visual
Substitui o texto existente por um novo texto em uma cadeia de caracteres de texto.
Sintaxe
SUBSTITUTE(<text>, <old_text>, <new_text>, <instance_num>)
Parâmetros
Termo | Definição |
---|---|
texto | O texto no qual você deseja substituir caracteres ou uma referência a uma coluna que contém texto. |
old_text | O texto existente que pretende substituir. |
new_text | O texto pelo qual pretende substituir old_text . |
instance_num | (facultativo) A ocorrência de old_text você deseja substituir. Se omitido, todas as instâncias do old_text são substituídas |
Valor devolvido
Uma cadeia de texto.
Observações
Use a função SUBSTITUIR quando quiser substituir texto específico em uma cadeia de texto; use a função REPLACE quando desejar substituir qualquer texto de comprimento variável que ocorra em um local específico em uma cadeia de texto.
A função SUBSTITUTE diferencia maiúsculas de minúsculas. Se maiúsculas e minúsculas não corresponderem entre texto e old_text, SUBSTITUTO não substituirá o texto.
Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).
Exemplo: substituição dentro de uma cadeia de caracteres
A fórmula a seguir cria uma cópia da coluna [Código do produto] que substitui o novo código de produto NW pelo código de produto antigo PA onde quer que ele ocorra na coluna.
= SUBSTITUTE([Product Code], "NW", "PA")