设计器函数汇总- FineReport帮助文档 - 全面的报表使用教程和学习资料

文档创建者：Coldman

历史版本：8

最近更新：Catqiu 于 2023-02-13

1. 概述

1.1 版本

报表服务器版本	功能变更
11.0	-

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	返回数的阶乘，一个数的阶乘等于123...该数。
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. 三角函数

函数名称	作用
SIN	计算给定角度的正弦值。
COS	返回一个角度的余弦值。
TAN	返回指定角度的正切值。
SINH	返回某一数字的双曲正弦值。
COSH	返回一个数值的双曲线余弦值。
TANH	返回某一数字的双曲正切值。
ASIN	返回指定数值的反正弦值。
ACOS	返回指定数值的反余弦值。
ATAN	计算指定数值的反正切值。
ATAN2	返回x、y坐标的反正切值。
ASINH	返回指定数值的反双曲正弦值。
ACOSH	返回给定数值的反双曲余弦。
ATANH	返回数字的反双曲正切值，该函数的参数值即为反双曲正切值的双曲正切值。
DEGREES	将弧度转化为度。
RADIANS	将角度转换成弧度。

5. 文本函数

函数名称	作用
CHAR	根据指定数字返回对应的字符。
CNMONEY	返回人民币大写。
CODE	计算文本串中第一个字符的数字代码。
CONCATENATE	将数个字符串合并成一个字符串。
ENDWITH	ENDWITH(str1，str2):判断字符串str1是否以str2结束。
ENMONEY	将给定的BigDemical类型的数字转换成英文金额字符串。
ENNUMER	将给定的BigDecimal类型的数字（100以内）取整后转化成英文金额的字符串。
EXACT	检测两组文本是否相同。
FIND	FIND(find_text,within_text,start_num):从指定的索引(start_num)处开始，返回第一次出现的指定子字符串(find_text)在此字符串(within_text)中的索引。
FORMAT	返回object的format格式。
INDEXOF	返回字符串str1在index位置上的字符。
LEFT	根据指定的字符数返回文本串中的第一个或前几个字符。
LEN	返回文本串中的字符数或者数组的长度。
LOWER	将所有的大写字母转化为小写字母。
MID	返回文本串中从指定位置开始的一定数目的字符。
NUMTO	返回number的中文表示。
PROPER	将文本中的第一个字母和所有非字母字符后的第一个字母转化成大写，其他字母变为小写。
REGEXP	字符串str是否与正则表达式pattern相匹配。
REPLACE	根据指定字符串，用其他文本来代替原始文本中的内容。
REPEAT	根据指定的次数重复显示文本。
RIGHT	根据指定的字符数从右开始返回文本串中的最后一个或几个字符。
SPLIT	SPLIT(String1,String2)：返回由String2分割String1组成的字符串数组。
STARTWITH	STARTWITH(str1，str2):判断字符串str1是否以str2开始。
SUBSTITUTE	SUBSTITUTE(text,old_text,new_text,instance_num):用new_text替换文本串中的old_text。
TODOUBLE	将文本转换成Double对象。
TOINTEGER	将文本转换成Integer对象，可以返回Long范围内的整数。
TRIM	清除文本首尾所有的空格。
UPPER	将文本中所有的字符转化为大写。
NUMTOZH	将数字转换成中文形式
ENBYSTRNUM	单元格按照指定字数换行显示
TEXTGETNUM	提取字符串中的数字，并按照原数字顺序显示
GETCHARNUM	计算字符串中指定字符个数
MIDCHAR	截取某字符前或后所有的字符

6. 日期和时间函数

函数名称	作用
DATE	返回一个表示某一特定日期的系列数。
DATEDELTA	DATEDELTA(date,deltadays):返回一个日期date后deltadays的日期。
DATEDIF	返回两个指定日期间的天数、月数或年数。
DATEINMONTH	函数返回在某一个月当中第几天的日期。
DATEINQUARTER	函数返回在某一个季度当中第几天的日期。
DATEINWEEK	函数返回在某一个星期当中第几天的日期。
DATEINYEAR	函数返回在一年当中第几天的日期。
DATESUBDATE	返回两个日期之间的时间差。
DATETONUMBER	返回自1970年1月1日00:00:00GMT经过的毫秒数。
DAY	返回日期中的日。
DAYS360	按照一年360天的算法（每个月以30天计，一年共计12个月），返回两日期间相差的天数。
DAYSOFMONTH	返回从1900年1月后某年某月包含的天数。
DAYSOFQUARTER	返回从1900年1月后某年某季度的天数。
DAYSOFYEAR	返回某年包含的天数。
DAYVALUE	返回1900年至date日期所经历的天数。
HOUR	返回某一指定时间的小时数。
MINUTE	返回某一指定时间的分钟数。
MONTH	返回日期中的月。
MONTHDELTA	MONTHDELTA(date,delta):返回指定日期date后delta个月的日期。
NOW	获取当前时间。
SECOND	返回某一指定时间的秒数。
TIME	返回指定的日期和时间, 日期会随当天的日期改变。
TODATE	函数可以将各种日期形式的参数转换为日期类型。
TODAY	获取当前日期。
WEEKDAY	获取日期并返回星期数。返回值为介于0到6之间的某一整数，分别代表星期中的某一天（从星期日到星期六）。
WEEK	返回一个代表一年中的第几周的数字。
WEEKDATE	返回指定年月的指定周的周几的具体日期。
YEAR	返回日期中的年。
YEARDELTA	YEARDELTA(date,delta):返回指定日期后delta年的日期。
LUNAR	返回当前日期对应的农历时间。
ENDOFMONTH	返回指定日期所在月份之前或之后月份的最后一天的日期值
ISWORKDAY	判断某日期是工作日还是周末

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. 层次坐标函数

函数名称	作用
ACCSUM	根据不同的分组对数据进行累计值计算。
MOM	计算同比或者环比
SUMIFS	统计满足多个条件的数据总量。
COUNTIFS	统计满足某些条件的单元格数量。
PROPORTION	计算扩展单元格的各个扩展值在汇总值中的占比
SORT	计算排名

上一篇：正则表达式

下一篇：常用函数概述

有帮助
没帮助
只是浏览

中文（繁體） English 日本語

中文（简体）

设计器函数汇总

1. 概述

1.1 版本

1.2 应用场景

2. 常用函数

3. 数学函数

4. 三角函数

5. 文本函数

6. 日期和时间函数

7. 逻辑函数

8. 数组函数

9. 报表函数

10. 其他函数

11. 层次坐标函数

附件列表