公式与函数

在制作表单时，可以设置控件与控件之间的数据联动关系。给例如编辑完单价和数量后，自动计算总价等这样的业务场景提供了支撑。

公式面板左侧可以选择当前表单控件所对应的值，以及所有表单控件所对应的字段名。被选择后，在公式面板中会以反引号包裹的形式显示。

注意：函数在简道云里的设置是大写，即在运用函数的时候，请用纯大写字母。

表单控件与其返回值的数据类型的对应关系如下表所示：

这里要说明的是，使用公式时，该字段一定要对应返回的数据类型。字符串或数字，不能混淆。

控件	返回数据类型
文本框	字符串
下拉框	字符串
单选按钮组	字符串
下拉复选框	数组
多选按钮组	数组
数字控件	数字
日期控件	时间戳(数字)

公式面板除了支持基本的运算操作符+、-、*、/，还支持比较操作符 >、<、>=、<=、==，同时也支持类似Excel中的部分函数公式，所有支持的函数公式如下：

逻辑函数

ADD
OR
FALSE
TRUE
IF
NOT
XOR

文本函数

CONCATENATE
EXACT
LEFT
LEN
LOWER
REPLACE
REPT
SEARCH
RIGHT
SPLIT
TRIM
UPPER
MID

数学函数

AVERAGE
COUNT
LARGE
MAX
MIN
SMALL
ABS
ROUND
CEILING
FLOOR
INT
LOG
MOD
POWER
PRODUCT
SQRT
SUM
FIXED

日期与时间函数

DATE
TIMESTAMP
TIME
TODAY
NOW
DAY
MONTH
YEAR
HOUR
MINUTE
SECOND
DAYS
DATEDELTA

高级函数

MAP

逻辑函数

返回true或者false一类的函数方法。

AND

AND(logical1, [logical2], …)

在参数组中，任何一个参数逻辑值为false，即返回false；只有当所有参数逻辑值为true，才返回true。

即是说，AND函数，是求括号里两个或多个逻辑式子共同满足true（逗号隔开的逻辑式子都满足）的时候，返回的结果为1，即true。

OR

OR(logical1,[logical2], …)

在参数组中，任何一个参数逻辑值为true，即返回true；只有当所有逻辑参数值为false，才返回false。

和AND函数一样，不同的地方在于，括号里只要有1个逻辑式为true，返回的结果就是1，也就是true。

FALSE

FALSE()

返回逻辑值false。

TRUE

TRUE()

返回逻辑值true。

TRUE和FALSE一样，都是强制括号中的逻辑式为1或0。

IF

IF(判断条件，结果为true的返回值, 结果为false的返回值)

判断一个条件能否满足；如果满足返回一个值，如果不满足则返回另外一个值。

在这个图里表示，如果数字1>0，那么返回1，否则返回0。可以写成IF(a,b,c)，表示如果a，那么b，否则c。函数支持嵌套，IF函数多层嵌套也是很常用的，如下图：

如果数字1>0，那么返回1，如果数字1<=0并且数字2>0，返回2，否则返回3。

NOT

NOT(logical)

对参数逻辑值求反。

NOT比较简单，就是把括号里为true的值变成false，括号里为false的值变为true。

XOR

XOR(logical1,[logical2], …)

返回所有参数的异或值。

异或的含义是，两个值相同，返回0，两个值不同，返回1。

文本函数

处理字符串文本的一系列函数方法。

CONCATENATE

CONCATENATE(text1,[text2], …)

将多个文本字符串合并成一个文本字符串。示例：

EXACT

EXACT(text1,text2)

比较两个字符串是否完全相同（区分大小写）。完全相同则返回true，否则返回false。示例：

LEFT

LEFT(text,[num_chars])

从一个文本字符串的第一个字符开始返回指定个数的字符。示例：

含义为，取字符串第1位开始的后面3位字符，即字符串1的第1到第3个字符。

LEN

LEN(text)

返回文本字符串中的字符个数。示例：

LOWER

LOWER(text)

将一个文本字符串中的所有大写字母转换为小写字母。

REPLACE

REPLACE(old_text, start_num, num_chars, new_text)

根据指定的字符数，将部分文本字符串替换为不同的文本字符串。

old_text: 必需。要替换其部分字符的文本。
start_num: 必需。old_text 中要替换为 new_text 的字符位置。
num_chars: 必需。old_text 中希望使用 new_text 来进行替换的字符数。
new_text: 必需。将替换 old_text 中字符的文本。

示例：

意义为：将字符串1中的第2位之后的4位，用字符串2来替换。

REPT

REPT(text, number_times)

将文本重复一定次数。

text: 必需。需要重复显示的文本。
Number_times: 必需。用于指定文本重复次数的正数。

SEARCH

SEARCH(find_text,within_text,[start_num])

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

find_text: 必需。要查找的文本。
within_text: 必需。要在其中搜索 find_text 参数的值的文本。
start_num: 可选。within_text 参数中从之开始搜索的字符编号。

示例：

表示从字符串2中的第1位开始搜索字符串1。

RIGHT

RIGHT(text,[num_chars])

返回文本值中最右边的字符。

text: 必需。包含要提取字符的文本字符串。
num_chars: 可选。指定希望提取的字符数。

SPLIT

SPLIT(text, text_separator)

将文本按指定字符串分割成数组。

TRIM

TRIM(text)

删除文本中的空格。

UPPER

UPPER(text)

将一个文本字符串中的所有小写字母转换为大写字母。

MID

MID(text, start_num, num_chars)

返回文本字符串中从指定位置开始的特定数目的字符，该数目由用户指定。

text: 必需。 包含要提取字符的文本字符串。
start_num: 必需。 文本中要提取的第一个字符的位置。 文本中第一个字符的start_num为 1，以此类推。
num_chars: 必需。 指定希望从文本中返回字符的个数。

这个函数将用的比较多，举一个在身份证号中提取生日的例子：

这个函数用了一个嵌套，用了前面说的CONCATENATE连接字符串的函数。提取身份证号的第7到10位，后面接“-”，提取身份证号的11、12位，接“-”，最后提取身份证号的13、14位。我们看下结果：

完美展现。

字符串函数综合运用举例

这里给出一个，根据身份证号码自动算性别的函数，笔者水平有限，无法把各种函数的综合运用一一例举，这里用一个典型的函数来给大家启发。

在这个表单里我要输入身份证号码，自动生成生日和性别。单行文本“性别”字段的函数为：

需要解释的是，身份证号码第17位为性别位，奇数为男性，偶数为女性。很多朋友提出为何不用MOD()函数（求余数的函数）来直接判断奇偶，而是要用这么复杂的一个IF()语句。因为身份证最后一位可能是X，也就是说用数字格式是不满足条件的。而且MID()取位函数只对字符串有效果，所以身份证号码本身是一个字符串，也就是单行文本控件，这是不支持数字运算的。所以MOD()函数不能用。

那么我们用OR()语句（或语句），就是说第17位为1,3,5,7,9的时候，返回“男”，否则返回“女”。我们看看效果：

第17位为2，性别“女”，生日为1980-01-01，完美展现。

数学函数

处理数字的一系列函数方法。

数学函数比较简单，下面罗列出了每个数学函数的功能，理解起来也比较方便，就不再举例说明。

AVERAGE

AVERAGE(number1, [number2], …)

返回参数的平均值（算术平均值）。

COUNT

COUNT(value1, [value2], …)

统计参数个数。

LARGE

LARGE(array,k)

返回数据集中第k个最大值。

Array: 必需。 需要确定第 k 个最大值的数组或数据区域。
k: 必需。 返回值在数组中的位置（从大到小排）。

MAX

MAX(number1, [number2], …)

返回一组值中的最大值。

MIN

MIN(number1, [number2], …)

返回一组值中的最小值。

SMALL

SMALL(array,k)

返回数据集中第k个最小值。

Array: 必需。 需要确定第 k 个最小值的数组或数据区域。
k: 必需。 返回值在数组中的位置（从小到大排）。

ABS

ABS(number)

返回数字的绝对值。

ROUND

ROUND(number, num_digits)

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

number: 必需。 要四舍五入的数字。
num_digits: 必需。 要进行四舍五入运算的位数。

CEILING

CEILING(number, significance)

返回将参数 number 向上舍入（沿绝对值增大的方向）为最接近的指定基数的倍数。

Number: 必需。 要舍入的值。
significance: 必需。 要舍入到的倍数。

FLOOR

FLOOR(number, significance)

将参数 number 向下舍入（沿绝对值减小的方向）为最接近的 significance 的倍数。

number: 必需。 要舍入的数值。
significance: 必需。 要舍入到的倍数。

INT

INT(number)

将数字向下舍入到最接近的整数。

LOG

LOG(number, [base])

根据指定底数返回数字的对数。

number: 必需。 想要计算其对数的正实数。
base: 可选。 对数的底数。 如果省略 base，则假定其值为 10。

MOD

MOD(number, divisor)

返回两数相除的余数。 结果的符号与除数相同。

number: 必需。 要计算余数的被除数。
divisor: 必需。 除数。

POWER

POWER(number, power)

返回数字乘幂的结果。

number: 必需。 基数。 可为任意实数。
power: 必需。 基数乘幂运算的指数。

PRODUCT

PRODUCT(number1, [number2], …)

函数使所有以参数形式给出的数字相乘并返回乘积。

SQRT

SQRT(number)

返回正的平方根。

SUM

SUM(number1, [number2], …)

函数使所有以参数形式给出的数字相加并返回和。

FIXED

FIXED(number, [decimals])

将数字舍入到指定的小数位数，以十进制数格式对该数进行格式设置，并以文本形式返回结果。

number: 必需。 要进行舍入并转换为文本的数字。
decimals: 可选。 小数点右边的位数。

日期与时间函数

用于处理日期和时间的一系列函数方法。

注意：日期控件的返回值为时间戳，单位是毫秒。而以下函数方法的参数大都是日期对象。所以可以用DATE函数处理成日期对象。

时间戳：时间戳是计算机记录时间的一种格式。通常是一个字符序列，唯一地标识某一刻的时间。数字时间戳技术是数字签名技术一种变种的应用。在简道云表单中，“日期时间”控件便是由这样的序列来存储的，因此在进行公式运算的时候要进行转换。

日期对象：日期对象的表示格式为“Sat Aug 01 2015 00:00:00 GMT+0800 (中国标准时间)”，即北京时间2015年8月1日00:00:00，这个日期对象可以进行各种运算，比如日期加减法等等。

DATE

DATE(timestamp)

将时间戳转换为日期对象。

timestamp: 必需。时间戳。

DATE(year,month,day)

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

将年月日时分秒转换为日期对象。

year: 必需。年份。
month: 必需。月份。
day: 必需。天数。
hour: 必需。小时。
minute: 必需。分钟。
second: 必需。秒。

例如，2015年12月1日的日期对象可以用如下表示：

DATE(2015,11,1)
DATE(1448899200000)
DATE(2015,11,1,0,0,0)
这三个都表示“Sun Nov 01 2015 00:00:00 GMT+0800 (中国标准时间)”

TIMESTAMP

TIMESTAMP(date)

将日期对象转换成时间戳。

TIME

TIME(hour, minute, second)

返回特定时间的十进制数字。时间值为日期值的一部分，并用十进制数表示（例如 12:00 PM 可表示为 0.5，因为此时是一天的一半）。

hour: 必需。 0（零）到 32767 之间的数字，代表小时。 任何大于 23 的值都会除以 24，余数将作为小时值。 例如，TIME(27,0,0) = TIME(3,0,0) = .125
minute: 必需。 0 到 32767 之间的数字，代表分钟。 任何大于 59 的值将转换为小时和分钟。 例如，TIME(0,750,0) = TIME(12,30,0) = .520833
second: 必需。 0 到 32767 之间的数字，代表秒。 任何大于 59 的值将转换为小时、分钟和秒。 例如，TIME(0,0,2000) = TIME(0,33,22) = .023148

TODAY

TODAY()

返回今天。

NOW

NOW()

返回当前时间。与TODAY函数相同。

DAY

DAY(date)

返回某日期的天数。 天数是介于 1 到 31 之间的整数。

MONTH

MONTH(date)

返回某日期的月份。 月份是介于 1 到 12 之间的整数。

YEAR

YEAR(date)

返回某日期的年份。

HOUR

HOUR(date)

返回某日期的小时数。

MINUTE

MINUTE(date)

返回某日期的分钟数。

SECOND

SECOND(date)

返回某日期的秒数。

DAYS

DAYS(end_date, start_date)

返回两个日期之间的天数。

end_date: 必需。结束日期。
start_date: 必需。起始日期。

DATEDELTA

DATEDELTA(date, deltadays)

将指定日期加/减指定天数。

date: 必需。初始日期。
deltadays: 必需。需要加减的天数。正数为增加，负数为减少。

日期格式综合运用举例：

例：根据生日计算年龄。

这里是表单，我想输入日期，计算出实际年龄。这时候姓名和出生日期不用多说，年龄可以采用数字或单行文本格式。公式如下：

解析：TODAY()返回的是date，即日期对象；DATE(‘出生日期’)返回的是date日期对象，然后都用YEAR()函数取年份，相减即可。

高级函数

用于获取表数据的一系列高级函数方法。

MAP

MAP(map_value, map_field, result_field)

当指定表单的map_field列的值为map_value时，返回result_field的所有值，返回结果为数组。类似Excel的LOOKUP函数。

map_value: 必需。条件字段值。
map_field: 必需。条件字段名。
result_field: 必需。结果字段名。

MAP函数是一个“跨表单”函数。即上面的所有函数都是在当前表单运算的函数，无法读取和调用已经提交的其他表单。MAP函数可以在一定程度上弥补这样的不足。

这里要区分一个概念。表单，正在编辑的表单，也叫表单，这里的跨表单可能指的是2个模板，在同一个应用里实现不同功能的字段都不是完全相同的模板。其实表单还有另外一个意思，2次提交同一个表单，拥有相同字段不同内容的两张表单。MAP函数应用的跨表单是后者，如果理解不了，只要记得MAP可以调用已填写的数据即可。

下面我们举例说明一下：

这里有一个选课表，课程信息字段里有几个可选择的课程，但是每个课程有人数限制，每当一个人报名，就要累加1个。

对“我是第几个报名的”字段进行编辑函数：

根据MAP函数的定义，括号里的第一个值为需要检索的值，第二个值为检索范围，第三个值为返回值。对于这个例子，可解释为：在所有录入过的“课程信息”字段里查找本次录入的“课程信息”，每找到一个本次录入的“课程信息”，就返回一个“我是第几个报名”，最后用COUNT函数统计一下返回了几个“我是第几个报名的”，当然这里用来计数的字段可以选择“请输入学号”或“姓名”。看一下效果：

选择了健身课，发现自己是第三个报名的，已经有2人报名。

简道云–专业的数据搜集管理工具
简道云用户反馈QQ群：217568252