Boost!for kintone
HOW TO WRITE

计算公式的写法

编写计算公式时的基本规则。

01

使用字段值

使用字段值时，请用“%”将字段代码括起来。固定字符串请用双引号（"）括起来。

示例

根据日期1字段的日期，返回截至执行处理当天的年龄。 

AGE(%日期1%)
02

连接字符串

连接字符串或函数的结果时，请用“+”连接。

示例

将数字1字段的值转换为字符串，并返回连接在“ABC”后面的结果。 

"ABC"+TO_STRING(%数字1%)
03

使用具有多个值的字段

复选框、选择用户等具有多个值的字段，其值会先转换为以逗号分隔的字符串，再用于计算。

转换后的值
字段类型 转换后的值
复选框、多选

所选的值 

"sample1,sample2"
选择用户、处理人

用户名 

"Noboru Sato,Misaki Kato"
选择组织

组织名 

"Development Department,Human Resources Department"
选择组

组名 

"Managers,Leaders"
创建人

创建人姓名 

"Creator"
更新人

更新人姓名 

"Modifier"

将值复制到相同类型的字段时，请使用FLAT函数。

04

将值放入具有多个值的字段

将值放入复选框、选择用户等具有多个值的字段时，请将计算结果设为各类型对应格式的字符串。

指定的值
字段类型 指定的值
复选框、多选

以逗号分隔的值的字符串 

"sample1,sample2"
选择用户

用“:”连接登录名和显示名后的值，再以逗号分隔的字符串 

"sato:Noboru Sato,kato:Misaki Kato"
选择组织

用“:”连接组织代码和组织名后的值，再以逗号分隔的字符串 

"dev:Development Department,hr:Human Resources Department"
选择组

用“:”连接组代码和组名后的值，再以逗号分隔的字符串 

"mgr:Managers,ldr:Leaders"

复制相同类型字段的值时，请使用FLAT函数。

FUNCTIONS

函数一览

计算公式中可以使用的函数及其写法。

01

IF

根据条件表达式的结果切换返回的值。

语法
IF(条件表达式,为真时的值,为假时的值)
参数
参数 说明
条件表达式

指定用比较运算符比较字段值、固定值或函数结果的表达式。

为真时的值

指定条件表达式为真时返回的值（固定值、函数结果、计算式）。

为假时的值

指定条件表达式为假时返回的值（固定值、函数结果、计算式）。

比较运算符
运算符 说明
=

左右的值相等时为真，不相等时为假。

!=

左右的值不相等时为真，相等时为假。

<

左边的值小于右边的值时为真，大于或等于右边的值时为假。

<=

左边的值小于或等于右边的值时为真，大于右边的值时为假。

>

左边的值大于右边的值时为真，小于或等于右边的值时为假。

>=

左边的值大于或等于右边的值时为真，小于右边的值时为假。

示例

数字1字段大于100时返回“1”，否则返回“0”。 

IF(%数字1%>100,1,0)
02

LIKE

在IF函数的条件表达式中，判断字符串中是否包含要搜索的字符串。

语法
LIKE(搜索对象字符串,要搜索的字符串)
参数
参数 说明
搜索对象字符串

指定字段代码、固定值或函数结果中的任意一种。

要搜索的字符串

指定字段代码、固定值或函数结果中的任意一种。也可以指定正则表达式。

示例

字符串1字段中包含“ABC”时返回“1”，否则返回“0”。 

IF(LIKE(%字符串1%,"ABC"),1,0)
03

AND

在IF函数的条件表达式中，判断是否满足所有条件。

语法
AND(条件表达式1,条件表达式2,...)
示例

数字1字段大于100且字符串1字段为“ABC”时返回“1”，否则返回“0”。 

IF(AND(%数字1%>100,%字符串1%="ABC"),1,0)
04

OR

在IF函数的条件表达式中，判断是否满足任意一个条件。

语法
OR(条件表达式1,条件表达式2,...)
示例

数字1字段大于100或字符串1字段为“ABC”时返回“1”，否则返回“0”。 

IF(OR(%数字1%>100,%字符串1%="ABC"),1,0)
05

TO_NUMBER

将字符串转换为数值。

语法
TO_NUMBER(%字段代码%或函数的结果值)
参数
参数 说明
字段代码或函数

用字段代码或函数的结果指定要转换的值。

示例

将字符串1字段的值转换为数值，并返回乘以2的结果。 

TO_NUMBER(%字符串1%)*2

无法转换为数值时返回“0”。

06

TO_STRING

将数值转换为字符串。

语法
TO_STRING(%字段代码%或函数的结果值)
参数
参数 说明
字段代码或函数

用字段代码或函数的结果指定要转换的值。

示例

将数字1字段的值转换为字符串，并返回连接在“ABC”后面的结果。 

"ABC"+TO_STRING(%数字1%)
07

TODAY

返回执行处理当天的日期。

语法
TODAY()
08

NOW

返回执行处理时的日期和时间。

语法
NOW()
返回值

返回的值因接收值的字段类型而异。

字段类型 返回的值
日期

执行处理时的日期（例：2026-10-18）

日期与时间

执行处理时的日期和时间

时间

执行处理时的时间（例：16:06）

其他

执行处理时的日期和时间（例：2026-10-18T16:06:00）

示例

以“16:06”的格式返回执行处理时的时间。 

DATE_FORMAT(NOW(),"H:i")
09

AGE

根据指定的日期，返回截至执行处理当天的年龄。

语法
AGE(%字段代码%或函数的结果值)
参数
参数 说明
字段代码或函数

用字段代码或函数的结果指定日期。

示例

根据日期1字段的日期，返回截至执行处理当天的年龄。 

AGE(%日期1%)
10

AVG

返回表格内数值字段的平均值。

语法
AVG(%字段代码%,用于限定对象行的布尔值)
参数
参数 说明
字段代码

指定表格内数值字段的字段代码。

用于限定对象行的布尔值

在Boost! Action中，在操作的条件中指定了表格内的字段时，如果只以符合条件的行为对象，请指定“true”。可以省略。

示例

返回数字1字段的平均值加1的结果。 

AVG(%数字1%)+1

在Boost! Action中，将表格内单选框的值指定为操作的条件时，返回符合条件的行的数字1字段平均值加1的结果。 

AVG(%数字1%,true)+1
11

COMMA

返回每3位用逗号分隔的数值字符串。

语法
COMMA(%字段代码%或函数的结果值,小数位数)
参数
参数 说明
字段代码或函数

用字段代码或函数的结果指定数值。

小数位数

指定要显示的小数位数。不显示小数时请指定“0”。

示例

返回以逗号分隔数字1字段值的字符串。 

COMMA(%数字1%,0)

指定位数以下的部分将被舍去。

12

DATE_CALC

返回在日期上加减年、月、日等后的结果。

语法
DATE_CALC(%字段代码%或函数的结果值,"计算模式(加减值 单位)")
参数
参数 说明
字段代码或函数

用字段代码或函数的结果指定日期、日期与时间或时间。

计算模式(加减值)

指定要加到计算基准日期上的数值。减去时请指定负数。也可以指定字段代码代替数值。

计算模式(单位)

在加减值后面空一个半角空格，指定以下单位。

单位
单位 说明
year

年

month

月

day

日

hour

小时

minute

分钟

second

秒

first-of-year

年初（1月1日）

first-of-month

月初（1日）

first-of-week

周初（星期日）

first-of-year、first-of-month、first-of-week不需要加减值。

用多个模式计算时，请用逗号分隔各个模式。

示例

返回日期1字段日期的2个月前的日期。 

DATE_CALC(%日期1%,"-2 month")

返回日期1字段日期所属月份的月末日期。 

DATE_CALC(%日期1%,"first-of-month,1 month,-1 day")

返回在日期1字段的日期上加上数字1字段天数后的日期。 

DATE_CALC(%日期1%,"%数字1% day")

返回日期1字段的日期所在周的周初日期加10天后的日期。 

DATE_CALC(%日期1%,"first-of-week,10 day")
13

DATE_DIFF

以指定显示格式的字符串返回两个日期之间的期间。

语法
DATE_DIFF(%开始日期字段%,%结束日期字段%或"TODAY","显示格式")
参数
参数 说明
开始日期字段

用字段代码或函数的结果指定期间的第一天。

结束日期字段

用字段代码或函数的结果指定期间的最后一天。如需求出截至执行处理当天的期间，请指定“"TODAY"”。

显示格式

组合以下符号进行指定。

显示格式
符号 说明
Y

经过的年数

M

除去经过年数后剩余的月数

FM

整个期间的月数

D

除去经过月数后剩余的天数

FD

整个期间的天数

示例

以“○年○个月”的格式返回从日期1字段到日期2字段的期间。 

DATE_DIFF(%日期1%,%日期2%,"Y年M个月")

以“○年○个月○天”的格式返回从日期1字段到执行处理当天的期间。 

DATE_DIFF(%日期1%,"TODAY","Y年M个月D天")
14

DATE_FORMAT

以指定显示格式的字符串返回日期。

语法
DATE_FORMAT(%字段代码%或函数的结果值,"显示格式")
参数
参数 说明
字段代码或函数

用字段代码或函数的结果指定日期。

显示格式

组合以下符号进行指定。

显示格式
符号 说明
Y

年（4位）

y

年（2位）

m

月（2位）

d

日（2位）

H

时（24小时制，2位）

h

时（12小时制）

i

分（2位）

s

秒（2位）

w

星期

示例

以“2026-10-18”的格式返回日期1字段的日期。 

DATE_FORMAT(%日期1%,"Y-m-d")

以“16:06”的格式返回执行处理时的时间。 

DATE_FORMAT(NOW(),"H:i")
15

FLAT

以逗号分隔的“代码:名称”字符串返回选择用户、选择组织、选择组、处理人、创建人、更新人字段的值。

语法
FLAT(%字段代码%)
参数
参数 说明
字段代码

指定要转换的字段的字段代码。

示例

用户1字段为空时返回登录用户，否则返回用户1字段的值。 

IF(%用户1%="",LOGINUSER(),FLAT(%用户1%))
16

LOGINUSER

以“登录名:显示名”的格式返回登录用户。

语法
LOGINUSER()
17

LOGINUSER_CODE

返回登录用户的登录名。

语法
LOGINUSER_CODE()
18

LOGINUSER_NAME

返回登录用户的显示名。

语法
LOGINUSER_NAME()
19

LPAD

返回在字符串左侧用指定字符填充至指定长度的结果。

语法
LPAD(%字段代码%或函数的结果值,字符串长度,"用于填充的字符")
参数
参数 说明
字段代码或函数

用字段代码或函数的结果指定原始值。

字符串长度

指定结果的字符数。

用于填充的字符

指定用于填充的字符。

示例

返回在数字1字段值的左侧用“0”填充至10位的结果。 

LPAD(%数字1%,10,"0")
20

RPAD

返回在字符串右侧用指定字符填充至指定长度的结果。

语法
RPAD(%字段代码%或函数的结果值,字符串长度,"用于填充的字符")
参数
参数 说明
字段代码或函数

用字段代码或函数的结果指定原始值。

字符串长度

指定结果的字符数。

用于填充的字符

指定用于填充的字符。

示例

返回在数字1字段值的右侧用“0”填充至10位的结果。 

RPAD(%数字1%,10,"0")
21

LEFT

从字符串左侧截取指定的字符数。

语法
LEFT(%字段代码%或函数的结果值,截取字符数)
参数
参数 说明
字段代码或函数

用字段代码或函数的结果指定原始值。

截取字符数

指定要截取的字符数。

示例

返回字符串1字段值左起5个字符。 

LEFT(%字符串1%,5)
22

RIGHT

从字符串右侧截取指定的字符数。

语法
RIGHT(%字段代码%或函数的结果值,截取字符数)
参数
参数 说明
字段代码或函数

用字段代码或函数的结果指定原始值。

截取字符数

指定要截取的字符数。

示例

返回字符串1字段值右起5个字符。 

RIGHT(%字符串1%,5)
23

MID

从字符串的指定位置截取指定的字符数。

语法
MID(%字段代码%或函数的结果值,截取开始位置,截取字符数)
参数
参数 说明
字段代码或函数

用字段代码或函数的结果指定原始值。

截取开始位置

指定开始截取的位置。第1个字符为“1”。

截取字符数

指定要截取的字符数。

示例

返回字符串1字段值从第3个字符开始的5个字符。 

MID(%字符串1%,3,5)
24

REPLACE

将字符串中的搜索字符串全部替换为替换字符串。

语法
REPLACE(%字段代码%或函数的结果值,"搜索字符串","替换字符串")
参数
参数 说明
字段代码或函数

用字段代码或函数的结果指定原始值。

搜索字符串

指定要替换的字符串。也可以指定正则表达式。

替换字符串

指定替换后的字符串。

示例

返回将字符串1字段值中的“股份有限公司”替换为“有限责任公司”后的结果。 

REPLACE(%字符串1%,"股份有限公司","有限责任公司")
25

LEN

返回字符串的字符数。

语法
LEN(%字段代码%或函数的结果值)
参数
参数 说明
字段代码或函数

用字段代码或函数的结果指定要计数的值。

示例

返回字符串1字段值的字符数。 

LEN(%字符串1%)
26

LENB

返回字符串的字节数。

语法
LENB(%字段代码%或函数的结果值)
参数
参数 说明
字段代码或函数

用字段代码或函数的结果指定要计数的值。

示例

返回字符串1字段值的字节数。 

LENB(%字符串1%)

字节数按UTF-8计算。中文、日文等字符大多为每个字符3个字节。

27

LINES

从多行字符串中返回指定行的字符串。

语法
LINES(%字段代码%或函数的结果值,获取行号)
参数
参数 说明
字段代码或函数

用字段代码或函数的结果指定原始值。

获取行号

指定要取出的行。第1行为“1”。

示例

返回字符串多行1字段值第3行的字符串。 

LINES(%字符串多行1%,3)
28

LOOP

在表格的各行中生成计算公式的结果，并返回用换行连接这些结果的字符串。

语法
LOOP(%字段代码%,/*计算公式*/,用于限定对象行的布尔值)
参数
参数 说明
字段代码

指定表格的字段代码。

计算公式

用“/*”和“*/”括起来指定在各行中生成值的计算公式。在要换行的位置输入“\\n”。

用于限定对象行的布尔值

在Boost! Action中，在操作的条件中指定了表格内的字段时，如果只以符合条件的行为对象，请指定“true”。可以省略。

示例

返回连接表格1各行中字符串1字段和数字1字段值的字符串。 

LOOP(%表格1%,/*"Item: "+%字符串1%+"\\nQuantity: "+TO_STRING(%数字1%)+"\\n"*/)

结果如下。 

Item: Orange
Quantity: 10

Item: Apple
Quantity: 15

Item: Kiwi
Quantity: 5

在Boost! Action中，将表格内单选框的值指定为操作的条件时，仅返回符合条件的行连接字符串后的结果。 

LOOP(%表格1%,/*"String: "+%字符串1%+"\\nNumber: "+TO_STRING(%数字1%)+"\\n"*/,true)

接收值的字段为富文本编辑器时，请用“<br>”代替换行进行连接。

29

MATH

返回计算公式的结果。

语法
MATH(计算公式)
参数
参数 说明
计算公式

指定计算公式。使用字段值时，请用“%”将字段代码括起来。

运算符
运算符 说明
+

加法

-

减法

*

乘法

/

除法

**

乘方

示例

返回数字1字段的值加2的结果。 

MATH(%数字1%+2)

返回数字1字段的值除以数字2字段的值的结果。 

MATH(%数字1%/%数字2%)
30

MAX

返回表格内字段的最大值。

语法
MAX(%字段代码%,用于限定对象行的布尔值)
参数
参数 说明
字段代码

指定表格内数值、日期、日期与时间或时间字段的字段代码。

用于限定对象行的布尔值

在Boost! Action中，在操作的条件中指定了表格内的字段时，如果只以符合条件的行为对象，请指定“true”。可以省略。

示例

返回数字1字段的最大值加1的结果。 

MAX(%数字1%)+1

在Boost! Action中，将表格内单选框的值指定为操作的条件时，返回符合条件的行的数字1字段最大值加1的结果。 

MAX(%数字1%,true)+1
31

MIN

返回表格内字段的最小值。

语法
MIN(%字段代码%,用于限定对象行的布尔值)
参数
参数 说明
字段代码

指定表格内数值、日期、日期与时间或时间字段的字段代码。

用于限定对象行的布尔值

在Boost! Action中，在操作的条件中指定了表格内的字段时，如果只以符合条件的行为对象，请指定“true”。可以省略。

示例

返回数字1字段的最小值减1的结果。 

MIN(%数字1%)-1

在Boost! Action中，将表格内单选框的值指定为操作的条件时，返回符合条件的行的数字1字段最小值减1的结果。 

MIN(%数字1%,true)-1
32

PREVROW

返回表格内字段上一行的值。

语法
PREVROW(%字段代码%,用于限定对象行的布尔值)
参数
参数 说明
字段代码

指定表格内字段的字段代码。

用于限定对象行的布尔值

在Boost! Action中，在操作的条件中指定了表格内的字段时，如果只以符合条件的行为对象，请指定“true”。可以省略。

示例

返回上一行数字1字段的值加1的结果。 

PREVROW(%数字1%)+1

在Boost! Action中，将表格内单选框的值指定为操作的条件时，返回符合条件的行中上一行数字1字段的值加1的结果。 

PREVROW(%数字1%,true)+1
33

ROWS

返回表格的行数。

语法
ROWS(%字段代码%,用于限定对象行的布尔值)
参数
参数 说明
字段代码

指定表格的字段代码。

用于限定对象行的布尔值

在Boost! Action中，在操作的条件中指定了表格内的字段时，如果只以符合条件的行为对象，请指定“true”。可以省略。

示例

返回表格的行数。 

ROWS(%表%)

在Boost! Action中，将表格内单选框的值指定为操作的条件时，返回符合条件的行数。 

ROWS(%表%,true)
34

SUM

返回表格内数值字段的合计值。

语法
SUM(%字段代码%,用于限定对象行的布尔值)
参数
参数 说明
字段代码

指定表格内数值字段的字段代码。

用于限定对象行的布尔值

在Boost! Action中，在操作的条件中指定了表格内的字段时，如果只以符合条件的行为对象，请指定“true”。可以省略。

示例

返回数字1字段的合计值加1的结果。 

SUM(%数字1%)+1

在Boost! Action中，将表格内单选框的值指定为操作的条件时，返回符合条件的行的数字1字段合计值加1的结果。 

SUM(%数字1%,true)+1
35

TIME_DIFF

以指定显示格式的字符串返回两个时间之间的经过时间。

语法
TIME_DIFF(%开始时间字段%,%结束时间字段%,"显示格式")
参数
参数 说明
开始时间字段

用日期与时间字段或时间字段的字段代码，或函数的结果指定开始时间。

结束时间字段

用日期与时间字段或时间字段的字段代码，或函数的结果指定结束时间。

显示格式

组合以下符号进行指定。

显示格式
符号 说明
H

经过时间中的小时部分

FH

整个经过时间的小时数

I

经过时间中的分钟部分

FI

整个经过时间的分钟数

示例

以“○小时○分钟”的格式返回从日期时间1字段到日期时间2字段的经过时间。 

TIME_DIFF(%日期时间1%,%日期时间2%,"H小时I分钟")

以小时数返回从时间1字段到时间2字段的经过时间。 

TIME_DIFF(%时间1%,%时间2%,"FH")

开始时间和结束时间请指定相同字段类型的值。

36

WEEK_CALC

以编号返回日期的星期。星期日为“0”，星期六为“6”。

语法
WEEK_CALC(%字段代码%或函数的结果值)
参数
参数 说明
字段代码或函数

用字段代码或函数的结果指定日期。

示例

返回日期1字段日期的星期编号。 

WEEK_CALC(%日期1%)