公式与函数
公式让你在引用变量时对数据做转换。本篇列出链盒内置的常用公式函数。 公式写在双花括号内,格式为 {{函数名(参数)}}。
文本函数
| 公式 | 说明 |
|---|---|
| text(val).substring(0, 100) | 截取前 100 字符 |
| text(val).trim() | 去除首尾空白 |
| text(val).toLowerCase() | 转小写 |
| text(val).toUpperCase() | 转大写 |
| text(val).replace("a", "b") | 替换字符串 |
| text(val).includes("key") | 是否包含子串 |
日期时间函数
| 公式 | 说明 |
|---|---|
| now() | 当前时间 |
| today() | 今天零点 |
| dateAdd(now(), 7, "days") | 当前时间加 7 天 |
| dateSub(now(), 1, "months") | 当前时间减 1 月 |
| formatDate(now(), "YYYY-MM-DD") | 格式化日期 |
数学函数
| 公式 | 说明 |
|---|---|
| toInt(val) | 转整数 |
| toNumber(val) | 转数字 |
| round(val) | 四舍五入 |
| sum(array) | 数组求和 |
| random() | 0-1 随机数 |
JSON 与对象函数
| 公式 | 说明 |
|---|---|
| toJson(str) | 字符串解析为 JSON |
| stringify(obj) | 对象转 JSON 字符串 |
| get(obj, "key") | 取对象字段(等价 obj.key) |
| keys(obj) | 对象的所有键 |
| object.get(obj, "a.b.c") | 按路径取嵌套字段 |
数组函数
| 公式 | 说明 |
|---|---|
| array.length(arr) | 数组长度 |
| array.first(arr) | 第一个元素 |
| array.last(arr) | 最后一个元素 |
| array.contains(arr, item) | 是否包含元素 |
| array.join(arr, ",") | 用分隔符拼接为字符串 |
组合使用
公式可以嵌套组合。例如把一个时间戳格式化成中文日期:
{{formatDate(now(), "YYYY年MM月DD日")}}从一段文本中提取并截断摘要:
{{text(trigger.body).trim().substring(0, 200)}}更多用法可参考数据传递与变量中的实际示例。