Ler em inglês

Compartilhar via


ESQUERDA

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

Prazo 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 de retorno

Uma cadeia de caracteres de texto.

Observações

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

  • 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

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 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.

Funções de texto