Compartilhar via


Função LEFT

Retorna o número especificado de caracteres do início de uma cadeia de texto.

Sintaxe

LEFT(<text>, <num_chars>)

Parâmetros

Termo

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

(opcional) O número de caracteres que você deseja que LEFT extraia; se omitido, 1.

Valor da propriedade/Valor do retorno

Uma cadeia de caracteres de texto.

Comentários

Enquanto o Microsoft Excel contém funções diferentes para trabalhar com texto em idiomas de caracteres de um byte e dois bytes, o DAX funciona com o Unicode e armazena todos os caracteres com o mesmo tamanho; portanto, uma única função é suficiente.

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

O exemplo a seguir retorna os primeiros cinco caracteres do nome da empresa na coluna [ResellerName] e as primeiras cinco 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 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.

Consulte também

Outros recursos

Funções de texto (DAX)