SUBSTITUTE
aplica-se a:coluna calculada
tabela calculada
medida
cá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
eold_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")
Conteúdo relacionado
Funções de texto REPLACE