Nesta página
> recursos > documentação > expressões > Funções condicionais

Funções condicionais

Funções para avaliação condicional, comparações e operações lógicas.

Padrões comuns

  • Categorização simples:

    if(Amount > 1000, "High", "Low")

  • Categorização em vários níveis: aninhe funções if para criar várias categorias:

    if(Amount >= 10000, "Enterprise",
   if(Amount >= 1000, "Business",
      if(Amount >= 100, "SMB", "Consumer")
   )
)

  • Usando a função bucket: para limites numéricos, bucket costuma ser mais simples:

    // Auto-generated labels
bucket(Amount, 100, 1000, 10000)
// Result: "<100", "100–1K", "1K–10K", or "≥10K"

// Custom labels
bucket(Amount, 100, "Small", 1000, "Medium", 10000, "Large", "Enterprise")

  • Condições baseadas em tempo:

    if(dayOfWeek(StartTime) in [6, 7], "Weekend", "Weekday")

if

(condition, thenValue, elseValue)

Retorna um valor quando uma condição é verdadeira e outro quando é falsa.

Parâmetros
condition boolean A condição a ser avaliada
thenValue any Valor a retornar se a condição for verdadeira
elseValue any Valor a retornar se a condição for falsa
Retorno qualquer
Exemplos
if(Amount > 1000, "High", "Low") → Alto ou Baixo
if(Status == "Approved", 1, 0) → 1 ou 0
if(5 > 3, "yes", "no") → sim
if(2 > 7, "a", "b") → b
Observações

Pode ser aninhada para lidar com várias condições.

min

(value1, value2, ...?)

Retorna o menor valor de uma lista de números.

Parâmetros
value1 number Primeiro valor
value2 number Segundo valor
... (opcional) number Valores adicionais, até 6 no total
Retorno número
Exemplos
min(5, 3, 8, 1) → 1
min(Amount, Budget) → o menor dos dois
Veja também
max

max

(value1, value2, ...?)

Retorna o maior valor de uma lista de números.

Parâmetros
value1 number Primeiro valor
value2 number Segundo valor
... (opcional) number Valores adicionais, até 6 no total
Retorno número
Exemplos
max(5, 3, 8, 1) → 8
max(Amount, MinimumAmount) → o maior dos dois
Veja também
min

bucket

(value, thresholds...)

Categoriza um valor em faixas com base em limites. Aceita rótulos gerados automaticamente ou personalizados.

Parâmetros
value number O valor a categorizar
thresholds... number | string Valores de limite, opcionalmente seguidos de rótulos
Retorno texto
Exemplos
bucket(Amount, 100, 1000, 10000) → <100, 100–1K, 1K–10K ou ≥10K

Rótulos gerados automaticamente

bucket(hour(StartTime), 6, "Night", 12, "Morning", 18, "Afternoon", "Evening") → Noite, Manhã, Tarde ou Noite

Rótulos personalizados

bucket(500, 100, 1000, 10000) → 100–1K
bucket(14, 6, "Night", 12, "Morning", 18, "Afternoon", "Evening") → Tarde
Observações

No modo automático, todos os argumentos depois do valor devem ser números. No modo manual, informe pares de limite/rótulo seguidos de um rótulo padrão.

Tópicos relacionados