Partilhar via


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 da cidade da empresa na coluna [City] e as cinco primeiras letras da chave do revendedor na coluna [ResellerKey] e os concatena para criar um identificador.

= CONCATENATE ( LEFT ( 'Reseller'[City], 5 ), LEFT ( 'Reseller'[ResellerKey], 5 ) )

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 [ResellerKey] contém números como 5, 24 e 312; portanto, o resultado também tem comprimento variável.

Funções de texto