Compartilhar via


Função REPLACE

REPLACE substitui parte de uma cadeia de texto, com base no número de caracteres que você especifica, por uma cadeia de texto diferente.

Sintaxe

REPLACE(<old_text>, <start_num>, <num_chars>, <new_text>)

Parâmetros

Termo

Definição

old_text

A cadeia de caracteres de texto que contém os caracteres que você deseja substituir, ou uma referência a uma coluna que contém texto.

start_num

A posição do caractere em old_text que você deseja substituir por new_text.

num_chars

O número de caracteres que você deseja substituir.

Observação sobre cuidadosCuidado

Se o argumento num_chars estiver em branco ou fizer referência a uma coluna que avalia um valor em branco, a cadeia de caracteres para new_text será inserida na posição start_num sem substituir nenhum caractere. Esse é o mesmo comportamento do Excel.

new_text

O texto de substituição dos caracteres especificados em old_text.

Valor da propriedade/Valor do retorno

Uma cadeia de caracteres de texto.

Comentários

Enquanto o Microsoft Excel tem funções diferentes a serem usadas com texto em idiomas de caracteres de um byte e dois bytes, o DAX usa o Unicode e, por isso, armazena todos os caracteres com o mesmo tamanho.

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

A fórmula a seguir cria uma nova coluna calculada que substitui os dois primeiros caracteres do código do produto na coluna, [ProductCode], com um novo código de duas letras, OB.

=REPLACE('New Products'[Product Code],1,2,"OB")

Consulte também

Referência

Função SUBSTITUTE

Outros recursos

Funções de texto (DAX)