Retorna uma Variante (Cadeia) que contém um número especificado de caracteres do lado esquerdo de uma cadeia.
Sintaxe
Esquerda(cadeia, comprimento)
A sintaxe da função Esquerda tem estes argumentos:
| Argumento | Descrição |
|---|---|
| cadeia | Obrigatório. Expressão de cadeia de caracteres cujos caracteres à esquerda são retornados. Se a cadeia contiver Nulo, será devolvido Nulo. |
| comprimento | Obrigatório. Variante (Longo). expressão numérica que indica quantos carateres pretende devolver. Se 0, uma cadeia de comprimento zero ("") será retornada. Se for maior ou igual ao número de carateres na cadeia, é devolvida toda a cadeia. |
Comentários
Para determinar o número de carateres na cadeia, utilize a função Len .
Observação
Utilize a função LeftB com dados de bytes contidos numa cadeia. Em vez de especificar o número de carateres a devolver, o comprimento especifica o número de bytes.
Exemplo de consulta
| Expressão. | Resultados |
|---|---|
| SELECT Left(ProductID,3) AS FromLeft FROM ProductSales; | Devolve "3" carateres do lado esquerdo dos valores no campo "ProductID" da tabela "Vendas de Produtos" na coluna FromLeft. |
Exemplo de VBA
Observação
Exemplos que se seguem demonstram a utilização desta função num módulo Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do Programador na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.
Este exemplo utiliza a função Esquerda para devolver um número especificado de carateres do lado esquerdo de uma cadeia.
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".