LEFT
Aplica-se a:
Coluna calculadaTabela calculadaMedidaCálculo visual
Retorna o número especificado de caracteres do início de uma cadeia de caracteres de texto.
Sintaxe
LEFT(<text>, <num_chars>)
Parâmetros
| Vigência | Definição |
|---|---|
text |
A cadeia de caracteres de texto que contém os caracteres que você deseja extrair ou uma referência a uma coluna que contém texto. |
num_chars |
(facultativo) O número de caracteres que você deseja extrair LEFT; se omitido, 1. |
Valor de retorno
Uma cadeia de texto.
Comentários
Considerando que o Microsoft Excel contém diferentes funções para trabalhar com texto em linguagens de caracteres de byte único e byte duplo, DAX funciona com Unicode e armazena todos os caracteres com o mesmo comprimento; portanto, uma única função é suficiente.
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
O exemplo a seguir retorna os cinco primeiros caracteres do nome da empresa na coluna [ResellerName] e as cinco primeiras letras do código geográfico na coluna [GeographyKey] e os concatena para criar um identificador.
= CONCATENATE(LEFT('Reseller'[ResellerName],LEFT(GeographyKey,3))
Se o argumento num_chars for um número maior do que o número de caracteres disponíveis, a função retornará o máximo de caracteres disponíveis e não gerará um erro. Por exemplo, a coluna [GeographyKey] contém números como 1, 12 e 311; portanto, o resultado também tem comprimento variável.