Posición del fragmento dentro del texto (0 = no lo encontró).
| Campo | Valor |
|---|---|
| Categoría | Texto |
| Tipo | Escalar (opera valor por valor) |
| Aridad | 2 a 3 argumentos |
| Se compila a SQL (columna calculada) | Sí |
| Versión | Motor de fórmulas v3. |
Alias#
Nombre canónico: LOCALIZAR. Alias aceptados (sin distinguir mayúsculas/minúsculas): search, find.
Sintaxis#
LOCALIZAR(expr; arg2; [arg3])Todos los argumentos son expresiones.
Retorno#
Número (posición, base 1; 0 cuando no lo encuentra).
Tratamiento de nulos#
No encontrar el fragmento devuelve 0 (no es un error).
Contexto de evaluación#
Escalar — se evalúa sobre el resultado de los argumentos (en las columnas calculadas, se ejecuta fila por fila).
Diferencias con DAX#
- Equivalente en DAX: SEARCH / FIND
- Compatibilidad: DIFIERE de DAX — semántica diferente, atención
- Observación: Devuelve 0 cuando no lo encuentra (el SEARCH/FIND de DAX devuelve ERROR). Siempre ignora mayúsculas/minúsculas — incluso con el alias
find, que en DAX las distinguiría.
Ejemplos#
LOCALIZAR("SP"; uf)Ejemplo con valores#
Entrada: busca "SP" en "RJ-SP-MG".
LOCALIZAR("SP"; "RJ-SP-MG") → 4Resultado esperado: 4
Ejemplo de negocio#
Estandarizar registros y etiquetas — CNPJ, SKU, nombre del canal, leyendas del informe.
Errores comunes#
Errores de escritura en el nombre de una columna, un tipo incompatible o un argumento inválido se convierten en un mensaje claro (pt-BR) — el motor nunca devuelve un número incorrecto en silencio.