ESCOLHER(valor; caso1; res1; ...; predeterminado?) — también acepta el nombre CASO.
| Campo | Valor |
|---|---|
| Categoría | Lógica |
| Tipo | Escalar (opera valor por valor) |
| Aridad | 3 o más argumentos |
| Se compila a SQL (columna calculada) | Sí |
| Versión | Motor de fórmulas v3. |
Alias#
Nombre canónico: ESCOLHER. Alias aceptados (sin distinguir mayúsculas/minúsculas): switch, caso.
Sintaxis#
ESCOLHER(expr; arg2; arg3; …)Todos los argumentos son expresiones.
Retorno#
El resultado del caso que coincidió, o el predeterminado.
Tratamiento de nulos#
El vacío se trata como falso (regla de la hoja de cálculo: 0 y el texto en blanco son falsos).
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: SWITCH
- Compatibilidad: Compatible con DAX
- Observación: SWITCH(valor; caso; resultado; …; predeterminado). Alias CASO.
Ejemplos#
ESCOLHER(uf; "SP"; 1; "RJ"; 2; 0)Ejemplo con valores#
Entrada: selección = 2.
ESCOLHER(2; 1; "um"; 2; "dois"; "outro") → "dois"Resultado esperado: "dois"
Ejemplo de negocio#
Aplicar una regla de negocio — rango de cliente, estado del pedido, meta alcanzada o no.
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.