MEMBRO SUPLENTE

Aplica-se a:Colunacalculada Tabelacalculada MedidaCá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")  

Conteúdos relacionados

Funções de texto
SUBSTITUIR