Compartilhar via


SUBSTITUTE

aplica-se a:coluna calculadatabela calculadaMeasurecá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 substitute caracteres, or uma referência a uma coluna que contém texto.
old_text O texto existente que você deseja replace.
new_text O texto com o qual você deseja replaceold_text.
instance_num (opcional) A ocorrência de old_text que você deseja replace. If omitido, todas as instâncias de old_text são substituídas

Retornar value

Uma cadeia de texto.

Comentários

  • Use a função SUBSTITUTE quando quiser replace texto específico em uma cadeia de texto; use a função REPLACE quando quiser replace 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. If caso not correspondência entre textandold_text, SUBSTITUTEnotreplace o texto.

  • Essa função not tem suporte para uso no modo DirectQuery quando usada em colunas calculadas or 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 [Product Code] que substitui o novo código productNW para o código de product antigo PA onde quer que ocorra na coluna.

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

Funções de texto REPLACE