Retorna uma Variante (Cadeia) que contém um número especificado de caracteres do lado esquerdo de uma cadeia.
Sintaxe
Esquerda(string, comprimento)
A sintaxe da função Left tem estes argumentos:
| Argumento | Descrição |
|---|---|
| cadeia | Obrigatório. Expressão de cadeia de caracteres cujos caracteres à esquerda são retornados. Se a cadeia de caracteres contiver Null, Null será retornado. |
| comprimento | Obrigatório. Variante (longa). Expressão numérica que indica quantos caracteres retornar. Se 0, uma cadeia de comprimento zero ("") será retornada. Se for maior ou igual ao número de caracteres na cadeia de caracteres, a cadeia de caracteres inteira será retornada. |
Comentários
Para determinar o número de caracteres na cadeia de caracteres, use a função Len .
Observação
Use a função LeftB com dados de byte contidos em uma cadeia de caracteres. Em vez de especificar o número de caracteres a serem retornados, o comprimento especifica o número de bytes.
Exemplo de consulta
| Expressão. | Resultados |
|---|---|
| SELECT Left(ProductID,3) AS FromLeft FROM ProductSales; | Retorna '3' caracteres do lado esquerdo dos valores no campo "IDProduto" da tabela "VendasDoProduto" na coluna FromLeft. |
Exemplo de VBA
Observação
Os exemplos a seguir demonstram o uso dessa função em um módulo do Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do desenvolvedor na lista suspensa ao lado de Pesquisar e insira um ou mais termos na caixa de pesquisa.
Este exemplo usa a função Left para retornar um número especificado de caracteres do lado esquerdo de uma cadeia de caracteres.
Dim AnyString, MyStr
AnyString = "Hello World" ' Define string.
MyStr = Left(AnyString, 1) ' Returns "H".
MyStr = Left(AnyString, 7) ' Returns "Hello W".
MyStr = Left(AnyString, 20) ' Returns "Hello World".