Compartilhar via


Função CONCATENATE

Une duas cadeias de texto em uma cadeia de texto.

Sintaxe

CONCATENATE(<text1>, <text2>)

Parâmetros

Termo

Definição

texto1, texto2

As cadeias de caracteres de texto a serem unidas em uma única cadeia de caracteres de texto. As cadeias de caracteres podem incluir texto ou números.

Também é possível usar referências de coluna.

Valor de retorno

A cadeia de caracteres concatenada.

Comentários

A função CONCATENATE une duas cadeias de caracteres de texto em uma cadeia de caracteres de texto. Os itens unidos podem ser texto, números ou valores Boolianos representados como texto ou uma combinação desses itens. Também será possível usar uma referência de coluna se a coluna contiver valores apropriados.

A função CONCATENATE na DAX aceita apenas dois argumentos, enquanto a função CONCATENATE do Excel aceita até 255. Se precisar concatenar várias colunas, você poderá criar uma série de cálculos ou, melhor, usar o operador de concatenação (&) para unir todos deles em uma expressão mais simples.

Se quiser usar cadeias de caracteres de texto diretamente, em vez de usar uma referência de coluna, você deve colocar cada cadeia de caracteres entre aspas duplas.

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: concatenação de literais

Descrição

A fórmula de exemplo cria um novo valor de cadeia de caracteres combinando dois valores de cadeia de caracteres fornecidos como argumentos.

Código

=CONCATENATE("Hello ", "World")

Exemplo: concatenação de cadeias de caracteres em colunas

Descrição

A fórmula de exemplo retorna o nome completo do cliente conforme listado em uma lista telefônica. Observe como uma função aninhada é usada como o segundo argumento. Essa é uma forma de concatenar várias cadeias de caracteres, quando há mais de dois valores que você deseja usar como argumentos.

Código

=CONCATENATE(Customer[LastName], CONCATENATE(", ", Customer[FirstName]))

Exemplo: concatenação condicional de cadeias de caracteres em colunas

Descrição

A fórmula de exemplo cria uma nova coluna calculada na tabela Customer com o nome de cliente completo como uma combinação de nome, inicial do meio e sobrenome. Se não houver nenhum nome do meio, o sobrenome virá logo depois do nome. Se houver um nome do meio, apenas a primeira letra do nome será usada e a letra inicial será seguida de um ponto.

Código

=CONCATENATE( [FirstName]&" ", CONCATENATE( IF( LEN([MiddleName])>1, LEFT([MiddleName],1)&" ", ""), [LastName]))

Comentários

Esta fórmula usa funções CONCATENATE e IF aninhadas, com o operador e comercial (&), para concatenar condicionalmente três valores da cadeia de caracteres e adicionar espaços como separadores.

Exemplo: concatenação de colunas com tipos de dados diferentes

O exemplo seguinte demonstra como concatenar valores em colunas que têm tipos de dados diferentes. Se o valor que você está concatenando for numérico, ele será convertido implicitamente em texto. Se ambos os valores forem numéricos, eles serão lançados como texto e concatenados como se fossem cadeias de caracteres.

Descrição do produto

Abreviação do produto (coluna 1 de chave composta)

Número do produto (coluna 2 de chave composta)

Nova coluna de chave gerada

Mountain bike

MTN

40

MTN40

Mountain bike

MTN

42

MTN42

Código

=CONCATENATE('Products'[Product abbreviation],'Products'[Product number])

Comentários

A função CONCATENATE na DAX aceita apenas dois argumentos, enquanto a função CONCATENATE do Excel aceita até 255. Se você precisar adicionar mais argumentos, será possível usar o operador e comercial (&). Por exemplo, a fórmula seguinte gera os resultados MTN-40 e MTN-42.

=[Product abbreviation] & "-" & [Product number]

Consulte também

Outros recursos

Funções de texto (DAX)