Primeiros N caracteres.
| Campo | Valor |
|---|---|
| Categoria | Texto |
| Tipo | Escalar (opera valor a valor) |
| Aridade | 2 argumentos (fixo) |
| Compila para SQL (coluna calculada) | Sim |
| Versão | Motor de fórmulas v3. |
Aliases#
Nome canônico: ESQUERDA. Aliases aceitos (maiúsc./minúsc. indiferente): left.
Assinatura#
code
ESQUERDA(expr; arg2)Todos os argumentos são expressões.
Retorno#
Texto.
Tratamento de nulos#
O vazio vira texto vazio ("").
Contexto de avaliação#
Escalar — avaliada sobre o resultado dos argumentos (nas colunas calculadas, roda linha a linha).
Diferenças para DAX#
- Equivalente DAX: LEFT
- Compatibilidade: Compatível com DAX
- Observação: Primeiros N caracteres.
Exemplos#
code
ESQUERDA(cnpj; 2)Exemplo com valores#
Entrada: "12345678", 2 primeiros.
code
ESQUERDA("12345678"; 2) → "12"Resultado esperado: "12"
Exemplo de negócio#
Padronizar cadastros e rótulos — CNPJ, SKU, nome do canal, legendas do relatório.
Erros comuns#
Erros de digitação em nome de coluna, tipo incompatível ou argumento inválido viram mensagem amigável (pt-BR) — o motor nunca devolve um número errado em silêncio.