Ler em inglês

Partilhar via


REPLACE

Aplica-se a:Coluna calculada Tabela calculada MedidaCálculo visual

REPLACE substitui parte de uma cadeia de texto, com base no número de caracteres especificado, por uma cadeia de texto diferente.

Sintaxe

DAX
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. Aviso: Se o argumento, num_chars, estiver em branco ou fizer referência a uma coluna avaliada como um espaço em branco, a cadeia de caracteres para new_text será inserida na posição, start_num, sem substituir nenhum caractere. Este é o mesmo comportamento que no Excel.
new_text O texto de substituição para os caracteres especificados no old_text.

Valor devolvido

Uma cadeia de texto.

Observações

  • Enquanto o Microsoft Excel tem diferentes funções para uso com linguagens de caracteres de byte único e byte duplo, o DAX usa Unicode e, portanto, armazena todos os caracteres como o mesmo comprimento.

  • 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

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

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

Funções de texto
Função SUBSTITUIR