飞书项目的度量计算字段函数清单 - 飞书官网

飞书项目的度量计算字段函数清单

飞书

​
函数 ​
介绍 ​
语法 ​
示例 ​
所属类型 ​
函数句柄 ​
+ ​
加法,用于数值之间的相加。 ​
v1 + v2 ​
1+2 == 3 ​
算术函数 ​
ret{整数 | 浮点数} add(v1{整数 | 浮点数}, v2{整数 | 浮点数}) ​
and ​
与,两真才真。 ​
condition1 and condition2 ​
​
逻辑运算 ​
ret{整数} and(v1{整数}, v2{整数}) ​
or ​
或,只有一个为真就为真。 ​
condition1 or condition2 ​
​
逻辑运算 ​
ret{整数} or(v1{整数}, v2{整数}) ​
= ​
等于 ​
v1 = v2 ​
1 = 1 ​
比较函数 ​
ret{整数} eq(v1{Any}, v2{Any}) ​
if ​
条件判断,用于两个值之间的比较,如 if 的第一个参数为 true,则返回第二个参数的值,否则返回第三个参数的值。 ​
if(condition, v1, v2) ​
if(1 > 0, "1", "2") == "1" ​
逻辑运算 ​
ret{Any} if(conf{整数}, v1{Any}, v2{Any}) ​
in ​
检查"1"是否属于数组"1","2"。如果元素不在数组中,返回 false;如果在,返回 true。 ​
in(v1 , v2) ​
in("1", ["1", "2"]) == true ​
逻辑运算 ​
ret{整数} in(v1{Any}, v2{AnyArray}) ​
- ​
减法,用于数值之间的相减。 ​
v1 - v2 ​
2-1 == 1 ​
算术函数 ​
ret{整数 | 浮点数} subtract(v1{整数 | 浮点数}, v2{整数 | 浮点数}) ​
* ​
乘法,用于数值之间的相乘。 ​
v1 * v2 ​
2*1 == 2 ​
算术函数 ​
ret{整数 | 浮点数} multiply(v1{整数 | 浮点数}, v2{整数 | 浮点数}) ​
/ ​
除法,用于数值之间的相除。 ​
v1 / v2 ​
2/1 == 2 ​
算术函数 ​
ret{整数 | 浮点数} divide(v1{整数 | 浮点数}, v2{整数 | 浮点数}) ​
% ​
取余,用于数值之间的取余。 ​
v1%v2 ​
4%3 == 1 ​
算术函数 ​
ret{整数} mod(v1{整数}, v2{整数}) ​
pow ​
求幂,用于数值的求幂。 ​
pow(number, number) ​
POW(2,3) == 8 ​
算术函数 ​
ret{浮点数} pow(v1{整数 | 浮点数}, v2{整数 | 浮点数}) ​
sqrt ​
开根号,接受一个数值类型的参数并返回该数值类型的平方根。 ​
sqrt(field) ​
SQRT(9) == 3 ​
算术函数 ​
ret{浮点数} sqrt({整数 | 浮点数}) ​
avg ​
用于对字段取平均值,仅接受数值类型 ​
AVG(field) ​
AVG(节点估分) == 3 ​
聚合函数 ​
ret{浮点数} avg(v1{整数 | 浮点数}) ​
min ​
用于对字段取最小值,仅接受数值类型 ​
MIN(field) ​
MIN(节点估分) == 6 ​
聚合函数 ​
ret{整数 | 浮点数 | 日期} min({整数 | 浮点数 | 日期}) ​
max ​
用于对字段取最大值,仅接受数值类型 ​
MAX(field) ​
MAX(节点估分) == 9 ​
聚合函数 ​
ret{整数 | 浮点数 | 日期} max({整数 | 浮点数 | 日期}) ​
sum ​
用于对字段取和,仅接受数值类型 ​
SUM(field) ​
SUM(节点估分) == 12 ​
聚合函数 ​
ret{整数 | 浮点数} add({整数 | 浮点数}) ​
median ​
用于对字段取中位数,仅接受数值类型 ​
MEDIAN(field) ​
MEDIAN(节点估分) == 6 ​
聚合函数 ​
ret{浮点数} add({整数 | 浮点数}) ​
count ​
获取字段包含值数量 ​
COUNT(field) ​
COUNT(名称) == 4 ​
聚合函数 ​
ret{整数} count({Any}) ​
avgIf ​
通过条件判断来获取字段的平均值 ​
AVGIF(condition, col) ​
AVGIF(优先级=="0",子任务估分) == 1 ​
聚合函数 ​
ret{浮点数} avg(v1{整数 | 浮点数}) ​
minIf ​
通过条件判断来获取字段的最小值 ​
MINIF(condition, col) ​
MINIF(优先级=="0",子任务估分) == 2 ​
聚合函数 ​
ret{整数 | 浮点数 | 日期} minIf(v1{整数 | 浮点数 | 日期},cond{整数}) ​
maxIf ​
通过条件判断来获取字段的最大值 ​
MAXIF(condition, col) ​
MAXIF(优先级=="0",子任务估分) == 3 ​
聚合函数 ​
ret{整数 | 浮点数 | 日期} maxIf(v1{整数 | 浮点数 | 日期},cond{整数}) ​
sumIf ​
通过条件判断来对字段求和 ​
SUMIF(condition, col) ​
SUMIF(优先级=="0",子任务估分) == 6 ​
聚合函数 ​
ret{整数 | 浮点数} sumIf(v1{整数 | 浮点数 | 日期},cond{整数}) ​
medianIf ​
通过条件判断来获取字段的中位数 ​
MEDIANIF(condition, col) ​
MEDIANIF(优先级=="0",子任务估分) == 9 ​
聚合函数 ​
ret{浮点数} medianIf(v1{整数 | 浮点数 | 日期},cond{整数}) ​
countIf ​
通过条件判断来获取字段包含值数量 ​
COUNTIF(condition,col) ​
COUNTIF(优先级=="0",名称) == 12 ​
聚合函数 ​
ret{整数} countIf(cond{整数}) ​
!= ​
不等于 ​
v1 != v2 ​
1 != 2 ​
比较函数 ​
ret{整数} notEq(v1{Any}, v2{Any}) ​
> ​
大于 ​
v1 > v2 ​
2 > 1 ​
比较函数 ​
ret{整数} gt(v1{Any}, v2{Any}) ​
>= ​
大于等于 ​
v1 >= v2 ​
2 >= 1 ​
比较函数 ​
ret{整数} gte(v1{Any}, v2{Any}) ​
< ​
小于 ​
v1 < v2 ​
1 < 2 ​
比较函数 ​
ret{整数} lt(v1{Any}, v2{Any}) ​
<= ​
小于等于 ​
v1 <= v2 ​
1 <= 2 ​
比较函数 ​
ret{整数} lte(v1{Any}, v2{Any}) ​
toStartOfMonth ​
获取当前月份的起始时间,向前取整到当前月份的第一天。 ​
toStartOfMonth(time) ​
toStartOfMonth("2021/05/15 18:25:30") == 2021/05/01 00:00:00 ​
日期函数 ​
ret{日期} toStartOfMonth({日期}) ​
empty ​
判断数值是否为空,空返回 true,非空返回 false。 ​
empty(str) ​
empty("") == true ​
字符串函数 ​
ret{整数} empty({字符串}) ​
has ​
检查"1","2"数组是否包含"1"。如果元素不在数组中,返回 false;如果在,返回 true。 ​
has(str, arry) ​
has("1",["1", "2"]) == true ​
数组操作函数 ​
ret{整数} has(val{Any}, arr{AnyArray}) ​
timeline ​
输出时间轴,支持 day、week、bi-week、month、bi-month、quarter 与 year 输出,不能与其他函数混合使用。 ​
timeline(startTime,endTime, "day") ​
timeline("2021/05/01", "2021/05/03", "day") ​
特殊函数 ​
timeline(start{日期}, end{日期}, size{字符串}) ​
toStartOfYear ​
获取当前年份的起始时间,向前取整到当前年度的第一天。 ​
toStartOfYear(time) ​
toStartOfYear("2021/05/15 18:25:30") == 2021/01/01 00:00:00 ​
日期函数 ​
ret{日期} toStartOfYear({日期}) ​
toStartOfQuarter ​
获取当前季度的起始时间,向前取整到当前季度的第一天。 ​
toStartOfQuarter(time) ​
toStartOfQuarter("2021/05/15 18:25:30") == 2021/04/01 00:00:00 ​
日期函数 ​
ret{日期} toStartOfQuarter({日期}) ​
toStartOfDay ​
获取当前天的起始时间,向前取整到今天开始。 ​
toStartOfDay(time) ​
toStartOfDay("2021/05/15 18:25:30") == 2021/05/15 00:00:00 ​
日期函数 ​
ret{日期} toStartOfDay({日期}) ​
toStartOfHour ​
获取当前小时的起始时间,向前取整到当前小时开始。 ​
toStartOfHour(time) ​
toStartOfHour("2021/05/15 18:25:30") == 2021/05/15 18:00:00 ​
日期函数 ​
ret{日期} toStartOfHour({日期}) ​
toStartOfMinute ​
获取当前分钟的起始时间,向前取整到当前分钟开始。 ​
toStartOfMinute(time) ​
toStartOfMinute("2021/05/15 18:25:30") == 2021/05/15 18:25:00 ​
日期函数 ​
ret{日期} toStartOfMinute({日期}) ​
toYear ​
提取年份,将输入的时间提取年份。 ​
toYear(time) ​
toYear("2021/05/08") == 2021 ​
日期函数 ​
ret{整数} toYear({日期}) ​
toMonth ​
提取月份,将输入的时间提取月份。 ​
toMonth(time) ​
toMonth("2021/05/01 18:25:30") == 5 ​
日期函数 ​
ret{整数} toMonth({日期}) ​
toHour ​
提取小时,将输入的时间提取为 24 小时制式小时。 ​
toHour(time) ​
toHour("2021/05/01 18:25:30") == 18 ​
日期函数 ​
ret{整数} toHour({日期}) ​
toMinute ​
提取分钟,将输入的时间提取分钟数。 ​
toMinute(time) ​
toMinute("2021/05/01 18:25:30") == 25 ​
日期函数 ​
ret{整数} toMinute({日期}) ​
toSecond ​
提取秒,将输入的时间提取秒数。 ​
toSecond(time) ​
toSecond("2021/05/01 18:25:30") == 30 ​
日期函数 ​
ret{整数} toSecond({日期}) ​
not ​
取非,将 true 与 false 之间互相转换 ​
not(condition) ​
not(false) == true ​
逻辑运算 ​
ret{整数} not({整数}) ​
lower ​
将字符串中的英文字符转换为小写。 ​
lower(str) ​
lower("MEEGO") == "meego" ​
字符串函数 ​
ret{字符串} lower({字符串}) ​
upper ​
将字符串中的英文字符转换为大写。 ​
upper(str) ​
upper("meego") == "MEEGO" ​
字符串函数 ​
ret{字符串} upper({字符串}) ​
reverse ​
反转字符串。 ​
reverse(str) ​
reverse("meego") == "ogeem" ​
字符串函数 ​
ret{字符串} reverse({字符串}) ​
substring ​
以字节为单位截取指定位置字符串。 ​
substring(str,start,end) ​
substring("meego", 0, 2) == "mee" ​
字符串函数 ​
ret{字符串} substring(str{字符串}, start{整数}, end{整数}) ​
length ​
返回字段(数组)中的元素个数。 ​
length(str) ​
length("meego") == 5 ​
字符串函数 ​
ret{整数} length({字符串}) ​
match ​
检查字段中的字符串是否与条件匹配。 ​
match(s1,s2) ​
match("meego", "go") == true ​
字符串函数 ​
ret{整数} match(s1{字符串}, s2{字符串}) ​
concat ​
将参数中的多个字段/字符串拼接。 ​
concat(s1,s2) ​
concat("mee", "go") == "meego" ​
字符串函数 ​
ret{字符串} length(s1{字符串}, s2{字符串}) ​
toString ​
将数字、字符串、时间转换为字符串。 ​
toString(str) ​
toString(2) == "2" ​
字符串函数 ​
ret{字符串} length({Any}) ​
DAY ​
返回两个日期之间的天数。 ​
day(startTime,endTime) ​
day("2021/08/08", "2021/08/20") == 12 ​
日期函数 ​
​
NOW ​
返回当前时间。 ​
now() ​
now() == 2021/08/08 18:25:00(建议系统展示当前时间) ​
日期函数 ​
​
countDistinct ​
用于对字段进行去重计数,仅接受数值类型 ​
countDistinct(col) ​
COUNTDISTINCT(名称) == 2 ​
聚合函数 ​
​
countDistinctIf ​
通过条件判断来对字段进行去重计数 ​
COUNTDISTINCTIF(condition,col) ​
COUNTDISTINCTIF(优先级=="0",名称) == 4 ​
聚合函数 ​
​
​
​
预约飞书企业效能顾问 深度诊断企业痛点,定制专属 AI 办公方案

字节跳动旗下 AI 工作平台

关联文章推荐

优质内容,精华实践

先进团队,先用飞书

欢迎联系我们,飞书效能顾问将为您提供全力支持
分享先进工作方式
输送行业最佳实践
全面协助组织提效
标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题

字节跳动旗下 AI 工作平台

联系我们立即试用