1. 帮助中心 >
  2. 帮助文档

公式与函数

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

函数公式是简道云提供的非常重要的功能,用户可以利用函数和公式创造一些适合自己的小功能。一些用户会觉得函数开始偏向与编程和写代码了,其实不然,简道云中的函数语法非常简单,花半个小时的功夫就能完全掌握。至于能用简道云提供的函数实现怎样的计算,这个就靠自己思考和与其他用户的奇思妙想结合了。


在了解函数怎么写之前,首先要了解这两个问题。

 
1. 函数在哪里设置

能做函数的控件,只有“单行文本”,“数字”和“时间日期”这三个。对应的数据格式分别为“字符串”、“数字”和“时间戳”。当然如果你是做业务的,不太明白“字符串”“数字”或“时间戳”含义的话,不要紧,后面会通过举例说明。    

知道了哪几个控件可以做函数,那么函数在哪里设置呢。每一个控件都可以设置默认值,这个默认值的默认选项是“自定义”,要改成“公式编辑”,然后在其下方会出现“编辑公式”按钮,点击即可编辑公式。如下图

 


2. 函数的主体是什么

就是说,函数是计算什么的,原始数据是来自什么。
 

一些用户表示,我从其他人那里复制一个函数过来,在我的表单中不生效呢。如上图所示,点击左侧“控件-文本”,右侧空白处将出现这个字段。注意: 所有的控件,都有一个内置的ID,而所能看见的控件名称,也仅仅是一个名称,所以当公式需要将控件值作为变量的时候,手动输入或复制粘贴都是无效的,因为字段名可以重复。如果需要将这个字段(控件)引入计算,需要手动点击左侧的字段列表。



3. 公式规则

(1)公式面板左侧可以选择公式所要用到的字段,被选择后,字段在公式面板中会以反引号包裹的形式显示。

(2)函数在简道云里的设置是大写,即在运用函数的时候,请用纯大写字母。

(3)公式面板除了支持基本的运算操作符+、-、*、/,还支持比较操作符>、<、>=、<=、==(等于)、!=(不等于),同时也支持类似Excel中的部分函数公式,所有支持的函数公式见下文的函数介绍。

(4)函数运用时要注意参数数据类型和返回值数据类型,一定要对应,不对应则无法获得正确的结果。例如公式的返回值是一个字符串,则不能把这个公式写在日期控件或者数字控件中。

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



4. 函数介绍


  • 逻辑函数

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


    AND

    AND(logical1, [logical2], ...)

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

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

    IF(AND(A,B,C),D,E),表示如果同时满足条件A,B,C,则返回D,否则返回E


    OR

    OR(logical1,[logical2], ...)

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

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

    IF(OR(A,B,C),D,E),表示如果满足条件A,或者满足条件B,或者满足条件C(即3个条件中满足一个或一个以上),则返回D,否则返回E


    FALSE

    FALSE()

    返回逻辑值false。


    TRUE

    TRUE()

    返回逻辑值true。

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


    IF

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

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

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

    (1)IF函数支持多层嵌套,如下图:


    (2)IF应用于下拉框/单选按钮组,如下图:


    (3)IF用于下拉复选框/复选框组,如下图:


    NOT

    NOT(logical)

    对参数逻辑值求反。

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


    XOR

    XOR(logical1,[logical2], ...)

    返回所有参数的异或值。

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


    文本函数

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


    CONCATENATE

    CONCATENATE(text1,[text2], ...)

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

    CONCATENATE(A,B,C),即返回值为ABC


    EXACT

    EXACT(text1,text2)

    比较两个字符串是否完全相同(区分大小写)。完全相同则返回true,否则返回false。示例:


    LEFT

    LEFT(text,[num_chars])

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


    LEN

    LEN(text)

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


    LOWER

    LOWER(text)

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


    REPLACE

    REPLACE(oldtext, startnum, numchars, newtext)

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

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

    REPLACE(字符串1,2,4,字符串2),即将字符串1中的第2位之后的4位(即2,3,4,5位),用字符串2来替换。


    REPT

    REPT(text, number_times)

    将文本重复一定次数。

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

    SEARCH(findtext,withintext,[start_num])

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

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

    RIGHT(text,[num_chars])

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

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


    SPLIT

    SPLIT(text, text_separator)

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


    TRIM

    TRIM(text)

    删除字符串首尾的空格,但会保留字符串内部作为词与词之间分隔的空格。


    UPPER

    UPPER(text)

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


    MID

    MID(text, startnum, numchars)

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

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

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


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


    TEXT

    TEXT(num)

    将数字转化成文本。

    TEXT(num,text_format)

    将数字转换成特定格式的文本。

    其中text_format的含义如下:

    • #:数字占位符。只显有意义的数据而不显示无意义的数据。小数点后数字如大于”#”的数量,则按”#”的位数四舍五入。小数点后数字如小于”#”的数量,则显示实际值。例:在文本框中输入:###.##,23.1显示为23.1,23.1578显示为23.16。

    • 0:数字占位补位符。如果小数点前的数据的长度大于占位符,则显示实际数据,如果小于占位符的数量,则用0补足。小数点后的数据的长度大于占位符,则按“0”的位数四舍五入。小数点后数字如小于”0”的数量,则用“0”补足。例:在文本框中输入:000.00,23.1显示为023.10,23.1578显示为023.16。

    • ,:千位分隔符。可插入“#”或“0”中使用,数字中插入千位分隔符。合法使用形式:1.需要在小数点前使用。2.需要在“#”或“0”之间。

    • %:百分比。放在数字占位符或补位符之后。数据以百分比形式显示。例:代码:#%,23.1显示为2310%。

    • [Num0]显示原始数据。

    • [Num1]将数字转为中文小写。123显示为一百二十三

    • [Num2]将数字转为中文大写。123显示为壹佰贰拾叁

    • 直接在[Num0]或#或0的之前加字符即是前缀,支持中文字符,英文大小写,¥,$,及空格。

    可根据自己需要自由组合.

    使用举例


    TEXT(date, text_format)

    其中text_format的含义如下:

    • yyyy表示年
    • MM表示月
    • dd表示日
    • HH表示24小时制的时
    • mm表示分
    • ss表示秒
    • E表示星期,结果为0~6,分别表示星期日~星期六
    • EE表示星期,例如:日、一、二等
    • EEE表示星期,例如:星期日、星期一、星期二等

    使用举例:


    VALUE

    VALUE(text)

    将文本转化为数字。


    GETUSERNAME

    GETUSERNAME(text)

    获取当前用户的昵称。

    举例:与其他字段组合,实现不允许重复提交


    字符串函数综合运用举例

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

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

    需要解释的是,身份证号码第17位为性别位,奇数为男性,偶数为女性。所以此处我们用两种方式来判断性别。

    (1)身份证的第17位数为奇数的时候,返回“男”,否则返回“女”。


    (2)身份证的第17位数为1,3,5,7,9的时候,返回“男”,否则返回“女”。


    我们看看效果:

    第17位为0,性别“女”,完美展现。


    数学函数

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


    AVERAGE

    AVERAGE(number1, [number2], ...)

    返回参数的平均值(算术平均值)。


    COUNT

    COUNT(value1, [value2], ...)

    统计参数个数。


    LARGE

    LARGE(array,k)

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

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


    MAX

    MAX(number1, [number2], ...)

    返回一组值中的最大值。


    MIN

    MIN(number1, [number2], ...)

    返回一组值中的最小值。

    用法同MAX函数。


    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: 必需。 要舍入到的倍数。

    用法同CEILING


    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], ...)

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


    SUMPRODUCT

    SUMPRODUCT(array1[array2])

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

    • array: 可选。多个数字数组。

    主要可用于计算加权和。例如:SUMPRODUCT([1,2,3],[0.1,0.2,0.3]),相当于1*0.1+2*0.2+3*0.3=1.4

    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)

    返回某日期的秒数。


    日期函数综合运用举例

    录入护照生效日期,自动计算到期时间,到期时间为年份+10,月份不变,天数-1。

    思路:提取出“护照生效日期”字段的年月日,进行加减计算出到期时间,再通过DATE()转换成日期对象,放入日期控件中得到“护照到期时间”


    DAYS

    DAYS(enddate, startdate)

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

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



    DAYS360

    DAYS360(enddate, startdate, method)

    按照一年 360 天的算法(每个月以 30 天计,一年共计 12 个月),DAYS360 函数返回两个日期间相差的天数,这在一些会计计算中将会用到。 如果财会系统是基于一年 12 个月,每月 30 天,可使用此函数帮助计算支付款项。

    • end_date: 必需。结束日期。
    • start_date: 必需。起始日期。
    • method: 可选。用于指定在计算中是采用美国方法还是欧洲方法。不填或false表示是美国方法,true表示是欧洲方法。


    DATEDELTA

    DATEDELTA(date, deltadays)

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

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


    WEEKNUM

    WEEKNUM(date, return_type)

    返回特定日期的周数。例如,包含1月1里的周为该年的第1周,其编号为第1周。

    • data: 必需。指定日期。代表一周中的日期。应使用DATE函数输入日期,或者将日期作为其他公式或函数的结果输入
    • return_type: 可选。一数字,确定星期从哪一天开始。默认值为1。


    从星期日开始计算周次


    从星期一开始计算周次


    效果如下:


    ISOWEEKNUM

    ISOWEEKNUM(date)

    返回给定日期在全年中的ISO周数。

    • data: 必需。日期是Ecxel用于日期和时间计算的日期-时间代码。


    高级函数

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

    MAPX

    MAPX(operation, mapvalue, mapfield, result_field)

    当指定表单的map_field列的值为map_value时,返回result_field的所有值,然后根据指定的聚合操作operation得到对应的返回值。

    • operation: 必需。聚合操作。
    • map_value: 必需。条件字段值。
    • map_field: 必需。条件字段名。
    • result_field:必需。字段返回值。

    其中operation参数为字符串,可选值如下:

    参数值 含义
    "first" 获取返回值的第一个
    "last" 获取返回值的最后一个
    "max" 最大值
    "min" 最小值
    "avg" 平均值
    "sum" 求和
    "count" 获取返回值的个数


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

    跨表有两种情况:(1)1张表单,录入时调用之前已经提交的数据。(2)2张表单。A表录入数据时,调用B表单已经录入的数据


    下面我们举例说明一下:
    这里有一个选课表,课程信息字段里有几个可选择的课程,但是每个课程有人数限制,每当一个人报名,就要累加1个。
    对“我是第几个报名的”字段进行编辑函数:



    根据MAPX函数的定义,括号里的第1个值为聚合操作,第2个值为需要检索的值,第3个值为检索范围,第4个值为返回值。对于这个例子,可解释为:在所有录入过的“课程信息”字段里查找本次录入的“课程信息”,每找到一个本次录入的“课程信息”,就返回一个“计数字段”(这里用来计数的字段可以选择“学号”或“姓名”),最后用COUNT函数统计一下返回了几个“之前已经报名的数量”,最后加1,得到“我是第几个报名的”。

    看一下效果:选择了健身课,发现自己是第2个报名的,前面已经有2人报名。




    UUID

    UUID()

    随机码生成器。

    可适用于随机流水号的使用场景等。

    RECNO

    RECNO()

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

    可适用于固定前缀或后缀的累加型流水号的使用场景等。

    使用举例:

    CONCATENATE('前缀',RECNO(),'后缀')