Partilhar via


Função SUBSTITUTE (DAX)

Substitui o texto existente por um 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 de 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.

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") 

Consulte também

Referência

Outros recursos