SUBSTITUTE

Aplica-se a:Coluna calculadaTabela calculadaMedidaCá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
text	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 de retorno

Uma cadeia de texto.

Observações

• Use a função SUBSTITUTE quando quiser substituir texto específico em uma cadeia de texto; Use a função REPLACE quando quiser substituir qualquer texto de comprimento variável que ocorra em um local específico em uma cadeia de caracteres de texto.

• A função SUBSTITUTE diferencia maiúsculas de minúsculas. Se maiúsculas e minúsculas não corresponderem entre text e old_text, SUBSTITUTE 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 do produto NW pelo código do produto antigo PA onde quer que ele ocorra na coluna.

= SUBSTITUTE([Product Code], "NW", "PA")

Conteúdo relacionado

Funções de textoREPLACE