Skip to content
Docs

This page has not been translated yet — you are reading the Portuguese version. View in Portuguese

Preview

ESCOLHER

On this page (10)

ESCOLHER(valor; caso1; res1; ...; padrão?) — também aceita o nome CASO.

CampoValor
CategoriaLógica
TipoEscalar (opera valor a valor)
Aridade3 ou mais argumentos
Compila para SQL (coluna calculada)Sim
VersãoMotor de fórmulas v3.

Aliases#

Nome canônico: ESCOLHER. Aliases aceitos (maiúsc./minúsc. indiferente): switch, caso.

Assinatura#

code
ESCOLHER(expr; arg2; arg3; …)

Todos os argumentos são expressões.

Retorno#

O resultado do caso que casou, ou o padrão.

Tratamento de nulos#

O vazio é tratado como falso (regra da planilha: 0 e texto em branco são falsos).

Contexto de avaliação#

Escalar — avaliada sobre o resultado dos argumentos (nas colunas calculadas, roda linha a linha).

Diferenças para DAX#

  • Equivalente DAX: SWITCH
  • Compatibilidade: Compatível com DAX
  • Observação: SWITCH(valor; caso; resultado; …; padrão). Alias CASO.

Exemplos#

code
ESCOLHER(uf; "SP"; 1; "RJ"; 2; 0)

Exemplo com valores#

Entrada: seleção = 2.

code
ESCOLHER(2; 1; "um"; 2; "dois"; "outro")  →  "dois"

Resultado esperado: "dois"

Exemplo de negócio#

Aplicar regra de negócio — faixa de cliente, status do pedido, meta batida ou não.

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.


← Voltar ao índice de fórmulas

Related links