本页内容
> 资源 > 文档 > 表达式 > 条件函数

条件函数

用于条件判断、比较和逻辑运算的函数。

常见模式

  • 简单分类：

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

  • 多级分类：嵌套使用if函数实现多个分类：

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

  • 使用Bucket函数：对于数值阈值，bucket通常更简洁：

    // 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")

  • 基于时间的条件：

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

if

(condition, thenValue, elseValue)

条件为真时返回一个值，否则返回另一个值。

参数
condition boolean 要评估的条件
thenValue any 条件为真时返回的值
elseValue any 条件为假时返回的值
返回值 任意类型
示例
if(Amount > 1000, "High", "Low") → High或Low
if(Status == "Approved", 1, 0) → 1或0
if(5 > 3, "yes", "no") → yes
if(2 > 7, "a", "b") → b
备注

可嵌套使用，以处理多个条件。

min

(value1, value2, ...?)

返回数字列表中的最小值。

参数
value1 number 第一个值
value2 number 第二个值
... (可选) number 其他值，最多共6个
返回值 数字
示例
min(5, 3, 8, 1) → 1
min(Amount, Budget) → 两者中的较小值
另请参阅
max

max

(value1, value2, ...?)

返回数字列表中的最大值。

参数
value1 number 第一个值
value2 number 第二个值
... (可选) number 其他值，最多共6个
返回值 数字
示例
max(5, 3, 8, 1) → 8
max(Amount, MinimumAmount) → 两者中的较大值
另请参阅
min

bucket

(value, thresholds...)

根据阈值将值分组。支持自动生成标签或自定义标签。

参数
value number 要分组的值
thresholds... number | string 阈值，可选填标签
返回值 字符串
示例
bucket(Amount, 100, 1000, 10000) → <100、100–1K、1K–10K或≥10K

自动生成的标签

bucket(hour(StartTime), 6, "Night", 12, "Morning", 18, "Afternoon", "Evening") → Night、Morning、Afternoon或Evening

自定义标签

bucket(500, 100, 1000, 10000) → 100–1K
bucket(14, 6, "Night", 12, "Morning", 18, "Afternoon", "Evening") → Afternoon
备注

自动模式下，值之后的所有参数都必须是数字。手动模式下，请提供阈值和标签对，并在最后提供默认标签。

相关主题