1. 概述
1.1 版本
1.2 应用场景
本文所描述的函数适用于「分页预览」、「填报预览」、「数据分析预览」、「移动端预览」以及「PC端预览」。
注：函数不支持在新填报插件下使用，会存在异常效果，建议将预览方式改为「填报预览」。
2. 常用函数
函数名称
| 作用 |
|---|
SUM
| 求一个指定单元格区域中所有数字之和 |
COUNT
| 计算数组或数据区域中所含项的个数 |
AVERAGE
| 返回指定数据的平均值 |
CHAR
| 根据指定数字返回对应的字符 |
DATE
| 返回一个表示某一特定日期的系列数 |
MAX
| 返回参数列表中的最大值 |
MIN
| 返回参数列表中的最小值 |
TIME
| 返回指定的日期和时间, 日期会随当天的日期改变 |
RANGE
| 函数表示从整数from开始，以step为每一步的大小，直到整数to的一个数字序列 |
3. 数学函数
函数名称
| 作用 |
|---|
ABS
| 返回指定数字的绝对值 |
AVERAGE
| 返回指定数据的平均值 |
BITNOT
| 将一个十进制整数进行二进制取反运算 |
BITOPERATION
| 返回两个整数根据op进行位运算后的结果 |
CEILING
| 将参数沿绝对值增大的方向，舍入为最接近的整数 |
COMBIN
| 返回若干个指定对象的组合数 |
COUNT
| 计算数组或数据区域中所含项的个数 |
| DECIMAL | 返回number的大数类型 |
EVEN
| 返回沿绝对值增大方向取整后最接近的偶数 |
EXP
| 返回e的n次幂。常数e为自然对数的底数，等于2.71828182845904 |
FACT
| 返回数的阶乘，一个数的阶乘等于1*2*3*...*该数 |
FLOOR
| 将参数沿绝对值减小的方向去尾舍入 |
INT
| 返回数字下舍入（数值减小的方向）后最接近的整数值 |
LN
| 返回一个数的自然对数 |
LOG
| 按指定的任意底数，返回数值的对数 |
LOG10
| 返回以10为底的对数 |
MAX
| 返回参数列表中的最大值 |
MIN
| 返回参数列表中的最小值 |
MOD
| 返回两数相除的余数 |
ODD
| 返回对指定数值进行舍入后的奇数 |
PI
| PI(number):是一个数学常量函数，当number为空时，函数返回精确到15位的数值3.141592653589793；当参数不为空时，number表示PI的整数倍数 |
POWER
| POWER(number,power):返回指定数字的乘幂 |
PRODUCT
| 将所有以参数形式给出的数字相乘，并返回乘积值 |
PROMOTION
| PROMOTION(value1,value2):返回value2在value1上提升的比例 |
RAND
| 返回均匀分布的随机数 |
RANDBETWEEN
| RANDBETWEEN(value1,value2):返回value1和value2之间的一个随机整数 |
ROUND
| 返回某个数字按指定位数舍入后的数字 |
ROUND5
| ROUND5(number,num_digits):将number按照指定的num_digits位数进行四舍五入，奇进偶不进 |
ROUNDDOWN
| ROUNDDOWN(number,num_digits):靠近零值，向下（绝对值减小的方向）舍入数字 |
ROUNDUP
| ROUNDUP(number,num_digits):远离零值，向上（绝对值增大的方向）舍入数字 |
SIGN
| 返回数字的符号。当数字为正数时返回1，为零时返回0，为负数时返回-1 |
SQRT
| 返回一个正数的平方根 |
SUM
| 求一个指定单元格区域中所有数字之和 |
SUMPRECISE
| 对精度有要求时，求一个指定单元格区域中所有数字之和 |
SUMSQ
| 返回所有参数的平方和 |
TOBINARY
| 将一个十进制整型数转换成二进制表示的字符串 |
TOHEX
| 将一个十进制整型数转换成十六进制表示的字符串 |
TOOCTAL
| 将一个十进制整型数转换成八进制表示的字符串 |
TRUNC
| 将数字的小数部分截去，返回整数 |
WEIGHTEDAVERAGE
| 返回指定数据的加权平均值 |
GCD
| 求1-255个数的最大公约数 |
LCM
| 求1-255个数的最小公倍数 |
4. 三角函数
5. 文本函数
6. 日期和时间函数
7. 逻辑函数
函数名称
| 作用 |
|---|
AND
| 当所有参数的值为真时，返回TRUE；当任意参数的值为假时，返回FALSE |
BITNOT
| 将一个十进制整数进行二进制取反运算 |
BITOPERATION
| BITOPERATIOIN(int,int,op)位运算，返回两个整数根据op进行位运算后的结果 |
IF
| IF(boolean,number1/string1,number2/string2):判断函数,boolean为true时返回第二个参数,为false时返回第三个 |
OR
| 当所有参数的值为假时，返回FALSE；当任意参数的值为真时，返回TRUE |
REVERSE
| 返回与参数相反的逻辑值 |
SWITCH
| switch(表达式,值1,结果1,值2,结果2,...): 如果表达式的结果是值1，整个函数返回结果1； 如果表达式的结果是值2，整个函数返回结果2等等 |
8. 数组函数
函数名称
| 作用 |
|---|
ADD2ARRAY
| ADD2ARRAY(array, insertArray, start):在数组第start个位置插入insertArray中的所有元素，再返回该数组 |
ARRAY
| ARRAY(arg1,arg2...):返回一个由arg1,arg2,...组成的数组 |
GREPARRAY
| GREPARRAY(array，fn):函数(返回true或者false)是条件，过滤此数组，最后形成一个新数组 |
INARRAY
| INARRAY(co,array):返回co在数组array中的位置，如果co不在array中，则返回0 |
INDEXOFARRAY
| INDEXOFARRAY(array,index):返回数组array的第index个元素 |
MAPARRAY
| MAPARRAY(array,fn):把一个数组中的项目转换到另一个数组中 |
RANGE
| 函数表示从整数from开始，以step为每一步的大小，直到整数to的一个数字序列 |
REMOVEARRAY
| REMOVEARRAY(array,start,deleteCount):从数组array中删除从第start个元素开始的deleteCount个数组元素，并返回删除后的数组 |
REVERSEARRAY
| 返回数组的倒序数组 |
SLICEARRAY
| SLICEARRAY(array,start,end):返回数组从第start个到第end个元素(包括第end个元素) |
SORTARRAY
| 返回数组排过序的数组 |
UNIQUEARRAY
| 去掉数组中的重复元素 |
JOINARRAY
| JOINARRAY(array,sepa):返回一个由sepa作为分隔符的字符串 |
9. 报表函数
函数名称
| 作用 |
|---|
COL
| 返回当前单元格的列号 |
COLCOUNT
| COLCOUNT(tableData):返回tableData中列的个数 |
COLNAME
| COLNAME(tableData,colIndex)返回的是tableData中列序号colIndex的列名 |
FIELDS
| FIELDS(connectionName,tableName):返回tableName这个表中的所有字段名 |
MAP
| MAP(object,string,int,int):四个参数分别是索引值,数据集的名字,索引值所在列序号,返回值所在列序号 |
RECORDS
| RECORDS(connection,table,field):返回数据库表table中字段名field下的所有元素 |
SQL
| SQL(connectionName,sql,columnIndex,rowIndex)返回通过sql语句从connectionName中获得数据表的第columnIndex列第rowIndex行所对应的元素 |
I18N
| i18n为本软件内置的国际化公式，可以对一些常用的词语进行国际化 |
ROW
| 返回当前单元格的行号 |
ROWCOUNT
| ROWCOUNT(tableData)：返回 TableData 的行数 |
TABLEDATAFIELDS
| TABLEDATAFIELDS(tableData)：返回tableData中所有的字段名 |
TABLEDATAS
| 返回报表数据集和服务器数据集名字 |
TABLES
| TABLES(connectionName)：返回名为 connectionName 的数据库中的所有表名 |
VALUE
| VALUE(tableData,col,row)返回tableData中列号为col的值,行号为row |
DECODE
| 使用指定的编码机制（UTF-8）对 application/x-www-form-urlencoded 字符串解码 |
ENCODE
| 使用指定的编码机制（UTF-8）将字符串转换为application/x-www-form-urlencoded格式 |
10. 其他函数
函数名称
| 作用 |
|---|
CLASS
| CLASS(object):返回object对象的所属的类 |
CORREL
| CORREL(array1,array2):求两个相同长度数据系列的相关系数(与Excel的同名函数作用相同) |
EVAL
| EVAL(exp)返回表达式exp计算后的结果 |
INDEX
| INDEX(key,val1,val2,...):返回key在val1,val2,...所组成的序列中的位置,不存在于序列中则返回参数的个数 |
ISNULL
| 判断对象中所有的值是否全部都是NULL或者为空字符串 |
LET
| LET(变量名,变量值,变量名,变量值,...,表达式):局部变量赋值函数,参数的个数N必须为奇数,最后一个是表达式，前面是N-1(偶数)为局部变量赋值对 |
MEDIAN
| 返回数据系列的中值(与Excel的同名函数作用相同) |
NVL
| 在所有参数中返回第一个不是null的值 |
RANK
| 返回一个数在一个数组中的秩 |
SEQ
| 返回数值，在整个报表执行过程中，返回该函数被第几次执行了 |
STDEV
| 计算数据系列的标准偏差(与Excel的同名函数作用相同) |
TOIMAGE
| 显示指定路径下的图片 |
WEBIMAGE
| 在web页面上显示指定路径下的图片 |
UUID
| 返回随机的UUID |
QUERY
| 用于解析 JSON 文本的函数 |
11. 层次坐标函数
