Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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
texteold_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")