CONCATENATE
Aplica-se a:
Coluna calculadaTabela calculadaMedidaCálculo visual
Junta duas cadeias de texto em uma cadeia de texto.
Sintaxe
CONCATENATE(<text1>, <text2>)
Parâmetros
| Vigência | Definição |
|---|---|
text1 |
A primeira cadeia de caracteres de texto a ser unida em uma única cadeia de texto. A cadeia de caracteres pode incluir texto ou números. Você também pode usar referências de coluna. |
text2 |
A segunda cadeia de caracteres de texto a ser unida em uma única cadeia de texto. A cadeia de caracteres pode incluir texto ou números. Você também pode usar referências de coluna. |
Valor de retorno
Uma cadeia de caracteres concatenada.
Comentários
A função CONCATENATE une duas cadeias de texto em uma cadeia de texto. Os itens associados podem ser texto, números, valores booleanos representados como texto ou uma combinação desses itens. Você também pode usar uma referência de coluna se a coluna contiver valores apropriados.
A função CONCATENATE no DAX aceita apenas dois argumentos, enquanto a função CONCATENATE do Excel aceita até 255 argumentos. Se precisar concatenar várias colunas, você pode criar uma série de cálculos ou usar o operador de concatenação (
&) para unir todas elas em uma expressão mais simples.Se quiser usar cadeias de texto diretamente, em vez de usar uma referência de coluna, coloque cada cadeia de caracteres entre aspas duplas.
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: concatenação de literais
A fórmula de exemplo cria um novo valor de cadeia de caracteres combinando dois valores de cadeia de caracteres que você fornece como argumentos.
= CONCATENATE("Hello ", "World")
Exemplo: Concatenação de cadeias de caracteres em colunas
A fórmula de exemplo retorna o nome completo do cliente conforme listado em um catálogo telefônico. Observe como uma função aninhada é usada como o segundo argumento. Essa é uma maneira de concatenar várias cadeias de caracteres quando você tem mais de dois valores que deseja usar como argumentos.
= CONCATENATE(Customer[LastName], CONCATENATE(", ", Customer[FirstName]))
Exemplo: concatenação condicional de cadeias de caracteres em colunas
A fórmula de exemplo cria uma nova coluna calculada na tabela Cliente com o nome completo do cliente como uma combinação de nome, inicial do meio e sobrenome. Se não houver um nome do meio, o sobrenome vem logo após o primeiro nome. Se houver um nome do meio, apenas a primeira letra do nome do meio é usada e a letra inicial é seguida por um ponto.
= CONCATENATE( [FirstName]&" ", CONCATENATE( IF( LEN([MiddleName])>1, LEFT([MiddleName],1)&". ", ""), [LastName]))
Esta fórmula usa CONCATENATE aninhadas e funções IF, juntamente com o operador E comercial (&), para concatenar condicionalmente três valores de cadeia de caracteres e adicionar espaços como separadores.
Exemplo: concatenação de colunas com diferentes tipos de dados
O exemplo a seguir demonstra como concatenar valores em colunas que têm tipos de dados diferentes. Se o valor que você está concatenando for numérico, o valor será implicitamente convertido em texto. Se ambos os valores forem numéricos, ambos os valores serão convertidos em texto e concatenados como se fossem cadeias de caracteres.
| Descrição do produto | Abreviatura do produto (coluna 1 da chave composta) | Número do produto (coluna 2 da chave composta) | Nova coluna de chave gerada |
|---|---|---|---|
| Bicicleta de montanha | MTN | 40 | MTN40 |
| Bicicleta de montanha | MTN | 42 | MTN42 |
= CONCATENATE('Products'[Product abbreviation],'Products'[Product number])
A função CONCATENATE no DAX aceita apenas dois argumentos, enquanto a função CONCATENATE do Excel aceita até 255 argumentos. Se precisar adicionar mais argumentos, você pode usar o operador E comercial (&). Por exemplo, a fórmula a seguir produz os resultados, MTN-40 e MTN-42.
= [Product abbreviation] & "-" & [Product number]