跳到主要内容

函数

一、逻辑函数​

1.1 IF​

IF(判断条件,真值, 假值)

函数简介​

根据判断条件的正确(true)或错误(false)，返回不同的值。

用法：IF(A,B,C)，表示如果满足条件A，那么返回B，否则返回C。

说明​

判断条件，真值，假值均为必填项，否则函数无法运算。

例子1​

判断等于，某个字段等于1显示为男，其他字段显示为女。 男女

例子2​

多个选择怎么做？比如在客服评价中，大于3是优秀，大于2是良好，大于1是普通。 多层

1.2 IFS​

函数简介​

判断多个条件，用IF进行嵌套不够直观。IFS可以将条件并列在一个括号中。

IFS(判断条件1, 真值1, 判断条件2（可选）, 真值2（可选）, ...)

函数概述：​

此函数用于检查一个或多个条件，返回第一个满足的条件对应的真值。

说明​

‘判断条件1’和‘真值1’是必填项，缺少任何一个参数都将导致函数无法执行；

如果‘判断条件1’不成立，则自动检查‘判断条件2’；若‘判断条件1’成立，将不会继续检查后续条件；

IFS函数不需要设置假值；如果所有条件均不满足，函数将输出空值“ ”作为默认的假值。

例子​

如判断客服评价，大于3是优秀，大于2是良好，大于1是普通。 IFS

1.3 AND​

函数简介​

只有当所有参数的逻辑值均为真（true）时，才会返回真（true）；若任何一个参数的逻辑值为假（false），则立即返回假（false）。

例子​

当两个分数都为60分及以上才能显示为毕业，否则显示为重考。 AND

1.4 OR​

函数简介​

只有当所有参数的逻辑值任何一个为真（true）时，会立即返回真（true）；若任何所有参数的逻辑值为假（false），则返回假（false）。

例子​

当两个分数有一个在60分及以上显示为毕业，否则显示为重考。 OR

1.5 XOR​

函数简介​

XOR(logical1,[logical2], …)

返回所有参数的异或结果。在异或逻辑中，如果两个值相同则返回假（false），如果两个值不同则返回真（true）。

说明​

logical:逻辑值，例如，2>1的逻辑值为true

1.6 NOT​

NOT(logical)

函数简介​

返回参数逻辑的反值，比如2>1是true，但是NOT(2>1)返回为false

1.7 ISEMPTY​

ISEMPTY(text)

函数简介​

判断字符串是否为空，如果是空值，返回true。 也可以判断附件是否上传。

二、文本函数​

2.1 CONCAT​

CONCAT(text1,[text2], …)

函数简介​

字符串连接函数，连接函数中的所有字段

例子​

链接固定文字“申请人名字”和一个字段值 CONCAT

2.2 MID​

MID(text, startnum, count)

函数简介​

返回字符串中从指定位置开始的特定数目的字符.

说明​

text： 一段字符串。

startnum：开始位置，从1开始。

count： 数量。

例子​

截取固定字符串"在中断和挫折中坚持不懈是成功的秘诀。"中的“坚持不懈”。 MID

2.3 LEFT​

LEFT(text,[count_chars])

函数简介​

从字段中从左侧第一个字符起，返回指定数量的字符.

说明​

text:字段或内容

count_chars:指定的字符数量

均为必填项否则函数无法运算。

2.3 RIGHT​

RIGHT(text,[count_chars])

函数简介​

从字段中从右侧第一个字符起，返回指定数量的字符.

说明​

text:字段或内容

count_chars:指定的字符数量

均为必填项否则函数无法运算。

2.4 LEN​

LEN(text)

函数简介​

返回参数中字符串的长度。

2.5 UPPER​

UPPER(text)

函数简介​

将文本字符串中的小写字母变成大写。

2.6 LOWER​

LOWER(text)

函数简介​

将文本字符串中的大写字母变成小写。

2.7 REPLACE​

REPLACE(oldtext, startnum, numchars, newtext)

函数简介​

根据指定的字符数，将字符串中部分内容替换为不同的字符串

说明​

oldtext:想要替换的字段或内容

startnum:指定的位置

numchars:指定的字符数量

newtext:替换的字段或内容

均为必填项，否则函数无法运算。

应用场景例子​

比如需要隐藏敏感信息，比如将电话18877779999，对外展示的时候替换中间的7777为XXXX。 REPLACE

SEARCH(findtext,withintext,start_num)

函数简介​

在第二个字段中查找第一个字段，并返回第一个字段字符串的起始位置的编号，该编号从第二个字段字符串的第一个字符算起。返回0则表示没有查到。

说明​

findtext:要查找的字段或者字符串，必填项

withintext:被查询的字段或者字符串，必填项

start_num ：查询的起始位置，不填默认为1。填写小于1的整数都算作是1。

2.8 TEXT​

TEXT(value,text_format)

函数简介​

将字段的值转化为特定格式的文本或数字

说明​

value:字段或内容

text_format:特定的格式，目前提供以下格式：

1.将日期时间字段的『 年月日，时分秒 』转化为『 YYYY-MM-DD,HH mm ss 』的特定格式(不填写时分秒也可以执行)。value,text_format均为必填项，否则函数无法运算。年月日时分秒对应 YYYY, MM, DD, HH, mm, ss。

2.9 JOIN​

JOIN("连接符号"，字段/文本)

函数简介​

允许用户自定义多值字段的连接符

说明​

连接符号：必填，内容为客户自定义，具体效果为替代当前文本传输出去时的默认连接符

字段/文本：必填且最少一个。

三、数字函数​

3.1 AVERAGE​

AVERAGE(number1, number2, …)

函数简介​

返回所有参与运算数字的平均值

说明​

number:数字字段或数字内容

至少要有一个及以上字段或内容，否则函数无法运算。

例子​

计算一次实验中，多个数据的平均数。 AVERAGE

3.2 COUNT​

COUNT(value1, [value2], …)

函数简介​

返回所有参与运算字段中值（字符串）的数量

3.2 COUNTIF​

COUNTIF(value1, [value2], …, criteria)

函数简介​

统计满足条件的参数个数。但参数类型不同时，设置有所区别。

COUNTIF([1,2,3,4], “>2”)，结果为2 COUNTIF([1,2,3,4], “!=2”)，结果为3 COUNTIF([1,2,3,4], “>=1”)，结果为4 COUNTIF([“a”, “b”, “c”], “d”)，结果为0

3.3 MAX​

MAX(number1, number2, …)或MAX(date1, date2, …)

函数简介​

返回所有参与数字/日期中的最大值

说明​

number:数字字段/数字内容

date：日期字段/日期内容

至少要有一个及以上字段或内容，否则函数无法运算。

3.4 MIN​

MIN(number1, number2, …)或MIN(date1, date2, …)

函数简介：

返回所有参与数字/日期中的最小值，用法同MAX()

说明：

number:数字字段或数字内容

date：日期字段/日期内容

3.5 ROUND​

ROUND(number, num_digits)

函数简介​

将数字四舍五入到指定的位数

说明​

number:数字字段或数字内容

num_digits：保留的位数

3.6 INT​

INT(number)

函数简介​

将数字向下取整

说明​

number:数字字段或数字内容

number必填，否则函数无法运算。

3.7 MOD​

函数简介​

返回两数相除的余数

说明​

number:数字字段或数字内容

divisor:除数

均为必填项，否则函数无法运算。

3.8 PRODUCT​

PRODUCT(number1, [number2], …)

函数简介​

返回所有参与字段中数值的乘积

说明​

number:数字字段或数字内容

至少要有一个及以上字段或内容，否则函数无法运算。

3.9 SUM​

SUM(number1, [number2], …)

函数简介​

返回所有参与字段中数值的总和

说明​

number：数字字段或数字内容

至少要有一个及以上字段或内容，否则函数无法运算。

3.10 SUMPRODUCT​

SUMPRODUCT([array1], [array2],[array3],...)

函数简介​

在给定的数组中，将数组间对应的元素相乘，并返回乘积之和

说明​

array:数字数组 至少要有一个及以上数组不为空值，否则函数无法运算。 不要求数组参数必须具有相同的维数，即如果数组内值的数量不一样，取乘积的最小值。例4，2，2的乘积之和是9，即1x1x1+2x2x2=9。

3.11 SUMIF​

SUMIF([array1],”text”, [array2(number)])

函数简介​

统计表格中符合条件的数值，并求和

说明​

array:数字数组

3.12 NUM​

NUM(text)

函数简介​

返回文本中的数字

说明​

可以获取单行文本，单项选择，下拉选择，数据关联字段中的数字。

3.13 RMBUPPER​

RMBUPPER(number)

函数简介​

把数字转换为大写的中文金额。

例如：35457.567

转化结果：叁万伍仟肆佰伍拾柒元伍角陆分柒毫

3.14 ROUNDUP​

ROUNDUP(number, num_digits)

函数简介​

将数字保留到指定的位数，最后一位向上取。

说明​

number:数字字段或数字内容

num_digits：保留的位数

均为必填项，否则函数无法运算。

3.15 ROUNDDOWN​

ROUNDDOWN(number, num_digits)

函数简介​

将数字保留到指定的位数，最后一位向下取。

说明​

number:数字字段或数字内容

num_digits：保留的位数

均为必填项，否则函数无法运算。

3.16 POWER​

POWER (number,number )

函数简介​

计算数字num的n次方，n可以为分数或者整数

说明​

number:数字字段或数字内容

均为必填项，否则函数无法运算。

3.17 LN​

LN(number)

函数简介​

计算指定数字的自然对数

说明​

number:数字字段或数字内容

number必填，否则函数无法运算

3.18 SQRT​

SQRT(number)

函数简介​

计算指定数字的平方根

说明​

number:数字字段或数字内容

number必填，否则函数无法运算

四、时间函数​

4.1 YEAR​

YEAR(date)

函数简介​

返回日期中的年份

说明​

date:日期字段，必填

4.2 MONTH​

MONTH(date)

函数简介​

返回日期中的月份，用法同YEAR()

说明​

date:日期字段，必填

4.3 DAY​

DAY(date)

函数简介​

返回日期中的天，用法同YEAR()

说明​

date:日期字段，必填

4.4 HOUR​

HOUR(date)

函数简介​

返回日期中的小时，用法同YEAR()

说明​

date:日期字段，必填

4.5 MINUTE​

MINUTE(date)

函数简介​

返回日期中的分钟，用法同YEAR()

说明​

date:日期字段，必填

4.6 SECOND​

SECOND(date)

函数简介​

返回日期中的秒，用法同YEAR()

说明​

date:日期字段，必填

4.7 DATE​

DATE(year,month,day,hour,minute)

函数简介​

将数字拼接成为日期

说明​

year:数字字段或数字内容

month:数字字段或数字内容

day:数字字段或数字内容

hour:数字字段或数字内容

minute:数字字段或数字内容

均为必填项，否则函数无法运算。

4.8 CURDATE​

CURDATE()

函数简介​

返回当前日期，可以在单行文本字段和日期字段中使用。

说明​

括号中无需填写内容，可以直接使用

4.9 NOW​

NOW()

函数简介​

返回当前日期时间,精准到时／分／秒，用法同CURDATE()。(日期字段需要勾选“精确到时／分／秒”，才能显示精准时间)

说明​

括号中无需填写内容，可以直接使用

4.10 DAYS​

DAYS(end_timestamp, start_timestamp)

函数简介​

返回两个日期字段之间的天数，可返回负值。例如，2018/1/30与2018/1/28相差2天。

说明​

end_timestamp: 必填项。结束日期。

start_timestamp: 必填项。起始日期。

4.11 DATEDELTA​

DATEDELTA(日期字段, 数量,时间单位)

函数简介​

将指定日期加/减指定天数，并显示目标日期。

说明​

日期字段：必填项。初始日期。

数量：必填项。需要加减的天数。正数为增加，负数为减少。

时间单位：天-D，月-M，年-Y，时-H，分-MIN

时间单位需要加英文双引号

4.12 NETWORKDAYS​

NETWORKDAYS（日期字段1,日期字段2, "weekend", 指定假期1, 指定假期2...）

函数简介​

返回两个日期之间的工作日数。

日期字段1：开始日期

日期字段2：结束日期

weekend：不用指定假期时为选填。周末字符串，用于指定周末日，未填写时默认周末为休息日。每个字符表示一周中的一天（从周日开始），共七个字符，其中用0表示工作日，用1表示休息日。例如：1100000表示周日和周一为休息日。

指定假期：选填，从工作日日历中排除的一个或多个日期。例如："2020-10-01"

说明​

如果 start_date 晚于 end_date，则返回值将为负数，数量将是所有工作日的数量

例子​

单个指定假期：NETWORKDAYS(日期1,日期2,"0000011", "2020-10-01")

多个指定假期：NETWORKDAYS(日期1,日期2,"0000011", "2020-10-01"，"2020-10-02"，"2020-10-03")

4.13 DATETOTIMESTAMP​

函数简介​

日期转时间戳函数，将日期转化为13位毫秒级时间戳，例：1596078632694。

说明​

data：日期字段，必填。

日期格式有年月日、年月日时分、年月日时分秒。前两者在更高精度的日期位统一补0。

对于格式错误的参数，统一返回 Invalid Value。

4.14 TIMESTAMPTODATE​

TIMESTAMPTODATE（时间戳）

函数简介​

时间戳转日期函数，时间戳统一转换为[年-月-日 时:分:秒]格式日期字符串。

说明​

时间戳：文本格式，必填。

用户可以在使用时根据需要截取。

需要兼容10位和13位时间戳。

对于格式错误的参数，统一返回 Invalid Value。

五、高级函数​

5.1 RDID​

RDID()

函数简介​

返回一个随机码，是字符串，请在文本字段里使用。

说明​

括号中无需填写内容，可以直接使用

5.2 RECNO​

函数简介​

累计器，依据当前表单被新打开的次数进行不断累加计算，起始值为1。

说明​

可用于流水号的自动生成。

5.3 TEXTUSER​

函数简介​

获取所选成员在通讯录中的名称或邮箱

如：

TEXTUSER（成员字段,"name"）获取所选成员在通讯录中的名称

TEXTUSER（成员字段,"email"）获取所选成员的邮箱

注意​

企业微信用户不支持使用TEXTUSER(成员字段,"name"）获取所选成员在通讯录中的名称

5.4 TEXTDEPT​

函数简介​

获取所选部门的名称或ID。

如​

TEXTDEPT(部门字段,"name"）获取所选部门的名称

TEXTDEPT(部门字段,"id"）获取所选部门的部门ID

注意​

企业微信用户不支持使用TEXTDEPT(部门字段,"name"）获取部门名称

5.5 GETUSERNAME​

GETUSERNAME()

函数简介​

获取当前用户的昵称

注意​

企业微信用户不支持该类型函数

5.6 GETUSEREMAIL​

GETUSEREMAIL()

函数简介​

获取申请人的邮箱

5.7 REGTEST​

REGTEST(文本字段/要验证的文本， 正则表达式规则，正则表达式修饰符)

函数简介​

根据用户指定的正则表达式，验证文本是否满足条件，满足返回true，不满足返回false，可以与IF等逻辑方法结合使用

注意​

正则中的\需要转义为 \

5.8 MD5​

MD5(加密内容，加密方式)

函数简介​

按照所选加密方式对插入的表单字段及文本进行加密

说明​

将文本MD5加密，可自定义加密的位数(16/32位)

加密内容：必填，文本，按照选定加密方式直接进行MD5加密。如果插入字段为多值字段（成员/部门/上传文件/多项&图片选择/表格子字段），则默认只取第一个值；若插入字段为富文本或定位，则不作处理直接取其文本；

加密方式：选填，填写16/32，对加密内容进行16/32位小写加密，不填写则默认32

函数案例​

将一条数据中的部分字段进行MD5加密后作为三方系统对接的鉴权参数

5.9 TRIPLEDES​

TRIPLEDES（内容，密钥, 向量，模式，填充）

函数概述​

此函数使用TRIPLEDES加密方法对内容进行加密，可以选择特定的加密模式和填充方式。

详细说明​

内容：必填。该字段为文本类型。使用NOPADDING填充时，内容长度必须是8的倍数，且将直接按照密钥进行TRIPLEDES加密。对于多值字段（如成员、部门、上传文件、多项&图片选择、表格子字段），默认仅取第一个值；若字段为富文本或定位，则直接取其文本内容（仅在Iso10126填充下支持）。

密钥：必填。密钥长度必须是8位的倍数。

向量：必填。长度必须是8位。在ECB模式下，偏移向量将被忽略。

模式：选填。可选择ECB、CBC或CTR模式，默认为ECB。ECB模式下不计算偏移向量，CTR模式仅支持NOPADDING填充。

填充：选填。可选择NOPADDING或Iso10126，默认为NOPADDING。

加密结果的byte数组将通过base64编码转换为字符串。

5.10 UNICODEENCODE​

UNICODEENCODE（字段/文本）

函数简介​

将字段/文本内容使用Unicode编码。

说明​

字段/文本：必填，要使用Unicode编码的内容。

5.11 UNICODEDECODE​

UNICODEDECODE（字段/文本）

函数简介​

将字段/文本内容使用Unicode解码。

说明​

字段/文本：必填，要使用Unicode解码的内容。

BASE64 BASE64(字段/文本)

函数简介​

将字段/文本内容进行base64编码。

说明​

字段/文本：必填，要使用base64编码的内容。 注意：文本内容不支持中文