Função SUBSTITUTE
Substitui o texto existente por texto novo 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 célula 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 omitido, todas as instâncias de old_text serão substituídas |
Valor da propriedade/Valor do retorno
Uma cadeia de caracteres de texto.
Comentários
Use a função SUBSTITUTE quando você quiser substituir texto específico em uma cadeia de caracteres de texto; use a função REPLACE quando quiser substituir um texto de tamanho variável que ocorre em um local específico em uma cadeia de caracteres de texto.
A função SUBSTITUTE diferencia maiúsculas de minúsculas. Se não houver correspondência entre text e old_text, SUBSTITUTE não substituirá o texto.
Esta função DAX pode retornar resultados diferentes quando usada em um modelo que é implantado e consultado no modo DirectQuery. Para obter mais informações sobre diferenças semânticas no modo DirectQuery, consulte https://go.microsoft.com/fwlink/?LinkId=219171.
Exemplo: substituição dentro de uma cadeia de caracteres
Descrição
A fórmula a seguir cria uma cópia da coluna [Product Code] que substitui o novo código do produto NW pelo código do produto antigo PA onde quer que ele ocorra na coluna.
Código
=SUBSTITUTE([Product Code], "NW", "PA")