计算公式是 REBUILD 自动化的核心能力之一。它能实现复杂的数据加工处理，如拼接截取文字、计算日期、条件分支逻辑，甚至调用 AI、请求外部接口、执行 SQL 查询。在 字段更新、数据校验 等功能中都会用到，编写方式一致，但请注意不同功能对公式返回值的要求不同。
计算公式要求你具备一定的编程基础，否则可能无法顺利进行
计算公式底层使用 Aviator 脚本语言实现，因此你可以编写任何符合 Aviator 语法的代码来实现业务需求。在开始使用前我们强烈建议你首先阅读 Aviator 文档，了解基本写法，尤其是 函数库列表 章节，高阶使用还会涉及 if 条件、for 循环 等。
先看一个简单的例子，以下计算公式取字段订单日期 orderDate，并加 10（天）后返回。
{orderDate} + 10
再看一个稍微复杂点的例子，以下计算公式取出字段订单日期 orderDate，如果订单日期为空则使用当前日期，然后加 10（天）后返回。
## 在本例中，由于是多行公式，所以需要使用 `;` `return` 完整语法，如是单行脚本则可以忽略
let date = {orderDate};
if (ISNULL(date)) {
date = CURRENTDATE();
}
return date + 10;
对于有一定编程基础的用户，相信对上述计算公式并不会感到陌生。我们用到了逻辑判断 if 条件，以及 ISNULL CURRENTDATE 函数（详见下文），接下来让我们继续学习。
在计算公式中，可以使用字段变量获取字段值，字段变量通过 {} 包裹，在公式执行时系统会将其替换为实际的字段值。例如下面的公式用于计算订单的到期时间。
## 获取订单日期，并调用 DATEADD 函数加 1 年后返回
let date = {orderDate};
return DATEADD(date, 1, 'Y');
为保持最大兼容性，系统对字段变量值进行了一些处理。在编写公式前请务必阅读以下说明：
0，对于非数字字段将处理为空字符串 ''。因此对于字段值的空值判断应为 if {ziduan} == '' 或 if {ziduan} == 0，而非 if {ziduan} == nil。我们推荐你使用 ISNULL 函数来判断空值，较为方便, 分隔，如 AAA, BBB）ID（20 位 Hash 字符串），如需获取文本值可使用 TEXT 函数进行转换ID 字符串（, 分隔），, 分隔），如果你想保持为 ID 可以通过点连接主键字段如 {duoyinyong.AccountId}对于引用字段可以使用 点连接 以便获取引用记录的数据。在计算公式中，多引用字段也支持点连接（用法与引用字段相同），需要注意的是，多引用字段返回的是一个数组，获取之后通常配合 for 循环 使用。
多引用字段点连接仅在 字段更新 触发器中可用
在触发器的计算公式中，还可以使用 {^字段名} 引用目标记录的字段值。在字段名前加 ^ 前缀表示该变量取值于目标记录而非源记录，常用于需要基于目标记录已有值进行计算的场景。
目标记录字段变量仅在 字段更新 触发器中可用
在函数语法中，$XXX 表示参数（可以是字段变量或是具体值），如果使用 [] 包裹则表示该参数为可选。同时注意函数名区分大小写、字段使用 {} 包裹、字符（串）使用引号包裹、数字无需包裹。
你可以将函数结果随意更新到一个文本字段，以便观察执行效果
TEXT($ID, [$DEFAULT])
$ID 表示 ID，可以是 ID 字段，也可以是具体的 ID 值，例如 837-018c2f7fa58e03f8$DEFAULT 当无法找到文本时使用的默认值（可选）TEXT({id}) TEXT({id}, '没有值')ID($TEXT, $ENTITY)
$TEXT 表示文本，可以是文本字段，也可以是具体的文本值，例如 锐昉科技$ENTITY 实体内部标识，表示在哪个实体中查找ID({no}, 'SalesOrder')TOSTR($OBJECT)
$OBJECT 任何对象TOSTR(CURRENTDATE())CHINESEYUAN($NUMBER)
$NUMBER 数字，可以是数字字段，也可以是具体的数字值，例如 9800CHINESEYUAN({jine}) CHINESEYUAN(123)HANLPPINY($STR, [$FIRST_CHAR])
$STR 中文字符，可以是字段或具体值，例如 锐昉科技$FIRST_CHAR 指定为 true 表示返回首字母，否则返回全拼HANLPPINY({kehuName}) HANLPPINY('锐昉科技')ISNULL($VALUE)
$VALUE 要判断的值，可以是字段，也可以是具体的值ISNULL({ziduan1}) ISNULL(0)IFNULL($VALUE, $DEFAULT)
$VALUE 要判断的值，可以是字段，也可以是具体的值$DEFAULT 为空时返回的默认值IFNULL({ziduan1}, '我是默认')CURRENTUSER()CURRENTUSER()CURRENTBIZUNIT()CURRENTBIZUNIT()CURRENTDATE()CURRENTDATE()TODATE($STR)
$STR 常用日期格式，如 2020-01-01、2020/01/01、2020-01-01 00:00:00TODATE('2025-10-20')DATEADD($DATE, $NUMBER, [$UNIT])
$DATE 日期，可以是日期字段，也可以是具体的日期值$NUMBER 要加的数量，支持正负数$UNIT 单位（可选，默认为 D）。I 表示分钟，H 表示小时，D 表示日，M 表示月，Y 表示年DATEADD({riqi1}, 10) DATEADD({riqi1}, 1, 'Y') DATEADD({riqi1}, '2H')DATESUB($DATE, $NUMBER, [$UNIT])
$DATE 日期，可以是日期字段，也可以是具体的日期值$NUMBER 要减的数量$UNIT 单位（可选，默认为 D）。I 表示分钟，H 表示小时，D 表示日，M 表示月，Y 表示年DATESUB({riqi1}, 10) DATESUB({riqi1}, 3, 'M')DATEDIFF($DATE1, $DATE2, [$UNIT])
$DATE1 $DATE2 两个日期，可以是日期字段，也可以是具体的日期值$UNIT 单位（可选，默认为 D）。S 表示秒，I 表示分钟，H 表示小时，D 表示日，M 表示月，Y 表示年DATEDIFF({date1}, {date2}) DATEDIFF({date1}, {date2}, 'H') DATEDIFF({date1}, CURRENTDATE(), 'M')DATEPICKAT($DATE, [Y|Q|M|D|H|I|W])
$DATE 表示日期，可以是日期字段，也可以是具体的日期值，如 2021-01-01 2023-01-01 10:01:02[Y|Q|M|D|H|I] 表示获取单位（可选，默认为 D）。Y 表示年，Q 表示季度，M 表示月，D 表示日，H 表示小时，I 表示分钟，W 表示周几（V3.6）DATEPICKAT({riqi1}) DATEPICKAT({riqi1}, "Q")CHINESEDATE($DATE, [$TRADITIONAL])
$DATE 日期，可以是日期字段，也可以是具体的日期值$TRADITIONAL 是否返回农历日期（可选，默认 false）CHINESEDATE({riqi1}) CHINESEDATE({riqi1}, true)OVERTIME($STARTTIME, $ENDTIME, [$WORKSTART, $WORKEND])
$STARTTIME 开始时间$ENDTIME 结束时间$WORKSTART $WORKEND 上下班时间，默认 09:00 18:00（可选）OVERTIME({kaishiTime}, {jieshuTime}) OVERTIME({kaishiTime}, {jieshuTime}, '08:30', '17:30')工作日只计上下班时间之外的部分，周末和法定节假日只计上下班时间之内的部分（每天最多计一个班次），自动识别调休工作日
SQLQUERY($SQL, [$PARAM1, $PARAM2, $PARAM3, $PARAM4, $PARAM5])
$SQL SQL 语句。请注意此语句非原生 SQL，可参考 AJQL$PARAM1 $PARAM2 $PARAM3 $PARAM4 $PARAM5 查询参数SQLQUERY("select fieldName from EntityName where fieldName2 = 'value' and fieldName3 = ?", {fieldName4})fieldName from EntityName where fieldName2 = 'value' 其中 select 关键词不是必须的fieldName1, fieldName2 from EntityName where fieldName2 = 'value' 注意 fieldName2 不会返回，因为仅支持查询一个字段，如需多个请使用 seqs 查询fieldName1 from EntityName where fieldName2 = 'value' order by fieldName2 desc 通过 order by 指定排序规则seq fieldName1 from EntityName where fieldName2 = 'value' 通过 seq 关键词可以查询多条记录的值，会返回一个一维数组/集合seqs fieldName1, fieldName2 from EntityName where fieldName2 = 'value' 通过 seqs 关键词可以查询多条记录的多个值，会返回一个二维数组/集合CONCATID($ID1, $ID2, [$ID3, $ID4, $ID5])
$ID1 ID 字段，可以是引用/多引用字段，也可以是具体的 ID 值，例如 999-0000000000000001$ID2 $ID3 $ID4 $ID5 同上CONCATID({kehu1}, {kehu2})CONCATARRAY($OBJ1, $OBJ2, [$OBJ3, $OBJ4, $OBJ5])
$OBJ1 任意字段或具体值$OBJ2 $OBJ3 $OBJ4 $OBJ5 同上CONCATARRAY({img1}, {file2})REPORT($ID, $REPORTID, [$FORCEPDF, $UPLOADPATH])
$ID 记录 ID（同时支持 ID 数组）$REPORTID 报表模板 ID$FORCEPDF 是否输出为 PDF（可选）$UPLOADPATH 是否上传并返回路径（否则返回文件对象），返回的路径可以放入 附件 字段（可选）REPORT({AccountId}, '032-019c221026970002')REPORT({AccountId}, '032-019c221026970002', true)在某报表的 [预览] 按钮上右键点击"复制链接"，链接后方的 ID 即为报表模板 ID，如 https://x.cn/admin/data/report-templates/preview?id=032-018e0cabba8b0001
ZIP($FILENAME, $FILE1, [$FILE2, $FILE3, $FILE4, $FILE5])
$FILENAME 压缩包文件名称$FILE1 $FILE2 $FILE3 $FILE4 $FILE5 要打包的文件，可以是媒体类字段（如图片、附件），或者是如通过 REPORT 导出的文件对象ZIP('压缩包.zip', {WenJian1}, {WenJian2})PDFMERGE($FILENAME, $FILE1, [$FILE2, $FILE3, $FILE4, $FILE5])
$FILENAME PDF 文件名称$FILE1 $FILE2 $FILE3 $FILE4 $FILE5 要合并的 PDF 文件，如果给定文件不是 PDF 则忽略PDFMERGE('合并的.pdf', {Pdf1}, {Pdf2}, {Pdf3})LOCATIONDISTANCE($LOC1, $LOC2)
$LOC1 表示起始坐标，可以是位置字段，也可以是具体的坐标值，例如 123.1234567,321.12345678$LOC2 表示结束坐标，可以是位置字段，也可以是具体的坐标值，例如 123.1234567,321.12345678LOCATIONDISTANCE({qiyundi}, {mudidi}) LOCATIONDISTANCE({qiyundi}, {mudidi}) / 1000REQUEST($URL, [$DEFAULT])
$URL 有效的请求地址，系统将从该地址获取结果$DEFAULT 当无法获取结果时使用的默认值（可选）REQUEST('http://xx/api/x?id=' + {id}, '')AIASK($USERCONTENT, [$FILE, $PROMPT])
$USERCONTENT 提问内容$FILE 文件（可选）$PROMPT 提示词（可选）AIASK('帮我分析一下这个文件', {File1})系统内置了一个字符处理工具集 StringUtils 用于常用文字处理，例如将字母转换为全大写 StringUtils.upperCase($TEXT)，关于此工具集所提供的方法请 参见文档。
Aviator 内置一些常用的处理函数，包括：
上述部分函数仅商业版本可用，如若不可用会提示
Function not found: XXX错误
以下示例覆盖常见的业务场景，供你参考。更多示例可参考 REBUILD 高级计算公式实战。
{ziduan1} + "和" + {ziduan2}
DATEDIFF({date1}, {date2}, "H")
DATEDIFF({date}, CURRENTDATE())
当字段 level 值为 A 时返回 优质客户，否则返回 普通客户：
if {level} == 'A' {
return '优质客户';
} else {
return '普通客户';
}
当字段 amount 为空时使用 0，并乘以折扣率：
IFNULL({amount}, 0) * {discount}
金额大于 10000 税率 15%，否则 10%：
if {jine} > 10000 {
return {jine} * 0.15;
} else {
return {jine} * 0.10;
}
将金额字段转换为大写，常用于合同、收据等：
CHINESEYUAN({jine})
查询订单明细中的产品 ID，循环取出产品名称并拼接：
let ids = SQLQUERY('seq ProductId from SalesOrderItem where SalesOrderId=?', {dingdan.SalesOrderId});
let s = '';
for id in ids {
s = s + TEXT(id) + ' / ';
}
return s;
对于复杂公式，有时我们希望可以进行调试，但目前并无直接调试方法。这里提供一个技巧，即使用 throw 关键词抛出一个异常（系统会弹窗提示 throw 的内容），然后借助异常达到调试的效果。
let shuzu = SQLQUERY('seq ProductId from SalesOrderItem where SalesOrderId=?', {dingdan.SalesOrderId});
## 抛出异常，页面会弹出错误提示
throw '这是个数组吗：' + shuzu;
## 循环拼接成字符串
let s = '';
for id in shuzu {
s = s + TEXT(id) + ' / ';
}
return s;
同时，你可以设定触发器的“附加过滤条件”限定触发器针对指定的记录生效，从而达到通过特定记录（例如一条测试数据）调试的目的。
公式执行报错通常有以下几种原因：
Function not found: XXX，说明函数名拼写有误或该函数不可用（部分函数仅商业版支持）TOSTR 或 TODATE 等函数进行类型转换{} 中的字段标识是否正确，区分大小写; 分隔语句并使用 return 返回结果如果错误信息不够明确，可使用
throw抛出中间变量的值来辅助排查
单行公式可以直接写表达式，无需 return，系统自动将结果作为返回值。多行公式（包含 if、for 等）则需要用 ; 分隔语句，并使用 return 明确指定返回值。
可以。计算公式底层基于 Aviator 脚本引擎，Aviator 内置的 函数库 均可在公式中使用，如字符串处理、数学计算、集合操作等。REBUILD 在此基础上扩展了 TEXT、ISNULL、CURRENTDATE 等业务相关函数。