CONCATENATE
aplica-se a:
coluna calculadatabela calculadamedidacálculo visual
Une duas cadeias de caracteres de texto em uma cadeia de caracteres de texto.
Sintaxe
CONCATENATE(<text1>, <text2>)
Parâmetros
| Prazo | Definição |
|---|---|
text1 |
A primeira cadeia de caracteres de texto a ser unida em uma única cadeia de caracteres 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 caracteres 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.
Observações
A função CONCATENATE une duas cadeias de caracteres de texto em uma cadeia de caracteres de texto. Os itens ingressados podem ser texto, números, valores boolianos 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 em DAX aceita apenas dois argumentos, enquanto a função CONCATENATE do Excel aceita até 255 argumentos. Se você precisar concatenar várias colunas, poderá 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 você quiser usar cadeias de caracteres de texto diretamente, em vez de usar uma referência de coluna, deverá colocar cada cadeia de caracteres entre aspas duplas.
Essa função não tem suporte para uso no modo DirectQuery quando usada em colunas calculadas ou regras de RLS (segurança em nível de linha).
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 uma lista telefônica. Observe como uma função aninhada é usada como o segundo argumento. Essa é uma maneira de concatenar várias cadeias de caracteres quando você tiver 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 nome do meio, o sobrenome virá diretamente após o nome. Se houver um nome do meio, somente a primeira letra do nome do meio será usada e a letra inicial será seguida por um período.
= CONCATENATE( [FirstName]&" ", CONCATENATE( IF( LEN([MiddleName])>1, LEFT([MiddleName],1)&". ", ""), [LastName]))
Essa fórmula usa funções aninhadas CONCATENATE e IF, juntamente com o operador ampersand (&), para concatenar condicionalmente três valores de cadeia de caracteres e adicionar espaços como separadores.
Exemplo: concatenação de colunas com tipos de dados diferentes
O exemplo a seguir demonstra como concatenar valores em colunas com tipos de dados diferentes. Se o valor que você está concatenando for numérico, o valor será convertido implicitamente 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 | Abreviação do produto (coluna 1 da chave composta) | Número do produto (coluna 2 da chave composta) | Nova coluna de chave gerada |
|---|---|---|---|
| Mountain bike | MTN | 40 | MTN40 |
| Mountain bike | MTN | 42 | MTN42 |
= CONCATENATE('Products'[Product abbreviation],'Products'[Product number])
A função CONCATENATE em DAX aceita apenas dois argumentos, enquanto a função CONCATENATE do Excel aceita até 255 argumentos. Se você precisar adicionar mais argumentos, poderá usar o operador de e comercial (&). Por exemplo, a fórmula a seguir produz os resultados, MTN-40 e MTN-42.
= [Product abbreviation] & "-" & [Product number]