简道云--公式与函数的使用教程

公式与函数

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

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

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

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

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

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

公式面板除了支持基本的运算操作符+、-、*、/，还支持比较操作符 >、<、>=、<=、==，同时也支持类似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