Compartilhar via


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
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 você deseja substituir.
new_text O texto pelo qual você deseja substituir old_text.
instance_num (opcional) A ocorrência de old_text que você deseja substituir. Se omitida, todas as instâncias de old_text serão substituídas

Valor de retorno

Uma cadeia de texto.

Comentários

  • Use a função SUBSTITUTE quando quiser substituir um texto específico em uma cadeia de caracteres 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 o caso não corresponder entre text e old_text, SUBSTITUTE não substituirá o texto.

  • Essa função não tem suporte para uso no modo DirectQuery quando usada em colunas calculadas ou regras de RLS (segurança em nível de linha).

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 ocorra na coluna.

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

Funções de texto REPLACE