Posição do trecho dentro do texto (0 = não achou).
| Campo | Valor |
|---|---|
| Categoria | Texto |
| Tipo | Escalar (opera valor a valor) |
| Aridade | 2 a 3 argumentos |
| Compila para SQL (coluna calculada) | Sim |
| Versão | Motor de fórmulas v3. |
Aliases#
Nome canônico: LOCALIZAR. Aliases aceitos (maiúsc./minúsc. indiferente): search, find.
Assinatura#
code
LOCALIZAR(expr; arg2; [arg3])Todos os argumentos são expressões.
Retorno#
Número (posição, 1-based; 0 quando não acha).
Tratamento de nulos#
Não achar o trecho devolve 0 (não é erro).
Contexto de avaliação#
Escalar — avaliada sobre o resultado dos argumentos (nas colunas calculadas, roda linha a linha).
Diferenças para DAX#
- Equivalente DAX: SEARCH / FIND
- Compatibilidade: DIFERE do DAX — semântica diferente, atenção
- Observação: Devolve 0 quando não acha (o SEARCH/FIND do DAX devolve ERRO). É sempre insensível a maiúsculas — inclusive pelo alias
find, que no DAX seria sensível.
Exemplos#
code
LOCALIZAR("SP"; uf)Exemplo com valores#
Entrada: procura "SP" em "RJ-SP-MG".
code
LOCALIZAR("SP"; "RJ-SP-MG") → 4Resultado esperado: 4
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.