HogQL 表达式指南

表达式概述

HogQL 表达式是一种强大的数据访问和处理工具，它允许您直接访问、修改和聚合数据。这些表达式可以在 PostHog 的多个功能中使用，包括过滤器、趋势分析、数据分组等。

函数	说明	示例
`if(条件, 真值, 假值)`	条件判断	`if(properties.$os == 'iOS', '苹果', '其他')`
`multiIf(条件1, 值1, 条件2, 值2, ..., 默认值)`	多重条件判断	`multiIf(properties.$os == 'iOS', '苹果', properties.$os == 'Android', '安卓', '其他')`
`in(值, 集合)`	检查值是否在集合中	`in(properties.$browser, ['Chrome', 'Firefox'])`
`match(值, 正则表达式)`	正则表达式匹配	`match(properties.$current_url, '^/blog/')`
`like`	模式匹配	`properties.$current_url like '%/blog%'`

函数	说明	示例
`extract(字符串, 模式)`	提取匹配内容	`extract(properties.$current_url, 'ref=([^&]*)')`
`concat(字符串1, 字符串2, ...)`	字符串连接	`concat(person.properties.$name, ' - ', properties.$browser)`
`splitByChar(分隔符, 字符串)`	字符串分割	`splitByChar(',', properties.tags)`
`replaceOne(字符串, 查找, 替换)`	替换第一个匹配	`replaceOne(properties.$current_url, 'https://', '')`

函数	说明	示例
`dateDiff('单位', 开始日期, 结束日期)`	计算日期差	`dateDiff('day', person.created_at, now())`
`toHour(timestamp)`	提取小时	`toHour(timestamp)`
`now()`	当前时间	`now()`
`today()`	今天日期	`today()`
`interval`	时间间隔	`now() - interval 7 day`

multiIf(
    properties.$device_type == 'Desktop', '桌面端',
    properties.$os == 'iOS', 'iOS设备',
    properties.$os == 'Android', '安卓设备',
    '其他'
)

extract(properties.$current_url, 'utm_source=([^&]*)')

multiIf(
    toHour(timestamp) < 6, '凌晨',
    toHour(timestamp) < 12, '上午',
    toHour(timestamp) < 18, '下午',
    '晚上'
)

properties.$browser = 'Chrome' 
AND dateDiff('day', timestamp, now()) <= 7
AND person.properties.is_active = true

toString(properties.$value)
toFloat(properties.$amount)
toDate(properties.$signup_date)