UReport2 函数

UReport2教学视频http://pan.baidu.com/s/1boWTxF5，密码：98hj

       在前一小节中，我们介绍了表达式，实际上函数也是表达式的一种。在UReport2当中提供了大量的内置函数，通过这些内置函数，可以实现各种各样的报表计算功能。函数语法格式如下：

      函数名([表达式,表达式...])

      下面我们就来逐个介绍UReport2内置的函数。

常用函数

count函数(统计数量)

        count函数是对给定的表达式在计算后对象数量进行统计。

sum函数(累加)

       sum函数是对给定的表达式在计算后值进行累加，sum函数要求各个表达式计算后的值必须是数字，否则将产生错误。

avg函数(求平均值)

       avg函数是对给定的表达式在计算后值求平均值，avg函数要求各个表达式计算后的值必须是数字，否则将产生错误。

max函数(求最大值)

       max函数是对给定的表达式在计算后值求其中的最大值，max函数要求各个表达式计算后的值必须是数字，否则将产生错误。

min函数(求最小值)

       min函数是对给定的表达式在计算后值求其中的最小值，min函数要求各个表达式计算后的值必须是数字，否则将产生错误。

row函数（取行号）

       取当前单元格所在行的行号，这个函数比较简单，它没有参数。

column函数（取列号）

      取当前单元格所在列的列号，这个函数比较简单，它没有参数。

order函数（排序）

       order函数需要两个参数，第一个为要进行排序的对象表达式，第二个是一个布尔值，用来设置排序方式，true正序，false为倒序。

list函数（罗列数据）

       取到表达式中定义所有数据，并以集合形式返回。

param函数（取参数）

       param函数用来获取外部传入的参数，它需要一个参数，用于指定要获取的参数名称。

emptyparam函数（判断参数是否为空）

       emptyparam函数用于判断指定的外部参数是否为null或空字符串，如果是返回true，否则返回false，该函数为2.2.3版本新增，如果要使用该函数，请注意您当前使用的ureport版本。

       emptyparam函数一般用于SQL数据集SQL表达式里，比如下面的写法：

${

   "select * from employee where 1=1 "+ (param("name")!=null && param("name")!="" ? "name=:name" : "")
} 

       上述的SQL判断采用的是param函数，由于要同时判断为null以及""，写起来比较麻烦，如改用emptyparam函数就简单多了。

${

   "select * from employee where 1=1 "+ (emptyparam("name")==false ? "and name=:name" : "")
} 

formatdate函数（格式化日期）

       对给定的日期参数进行格式化，它至少需要一个参数，第一个参数是要格式化的日期类型的对象，第二个参数是可选的，用于定义格式化采用的模式，如不指定则用默认的：yyyy-MM-dd HH:mm:ss来进行格式化。

formatnumber函数（格式化数字）

       对给定的参数进行格式化，它至少需要一个参数，第一个参数是要格式化的数字对象，要保证这个参数值取到后可以转换成日期，否则将发生错误；第二个参数是可选的，用于定义数字格式化采用的模式，如不定义，则采用默认的#来进行格式化。

get函数（获取指定位置数据）

       get函数是2.1.2版本中新增的，它的作用是获取数据集中指定位置的对象或对象的某个属性值。get函数可以有三个参数，第一个为目标集合对象、第二个为数据位置、第三个是对象属性，其中第一个参数是必须的，后面两个参数为可选。

分页相关函数

       所谓分页相关函数，是指这些函数是在分页的时候进行计算，比如计算当前页有多少条记录、当前页某个单元格值累加后是多少、平均值是多少、最大值是多少等等。

分页相关函数使用一般来说，分页相关函数多用在行类型为“重复表头”或“重复表尾”的行中的单元格里。同时，需要注意的是，分页相关函数只会在分页预览时显示，这点需要注意。

pcount函数

       统计当前页下表达对应值的数目，与count函数的使用方法基本一致，不同之处在于pcount只会统计当前页中对应的表达式内容的数目。

psum函数

        将当前页下表达式对应的所有值进行累加，与sum函数对应，不同的是psum只针对当前页。

pmax函数

       比较当前页中，表达式对应的值，找出其中最大的那个值，与max函数对应，只是pmax只针对当前页。

pmin函数

       比较当前页中，表达式对应的值，找出其中最小的那个值，与min函数对应，只是pmin只针对当前页。

page函数

       输出当前所在页的页码，该函数没有参数。

pages函数

       输出当前报表一共有多少页，该函数没有参数。

pages函数的使用范围pages函数目前仅能在页眉页脚中使用

数学函数

abs函数（绝对值）

       求参数的绝对值，参数值计算后数据类型必须是数字，否则会报错。

ceil函数（最小值）

       对参数值取最小值，如果参数值为小数将舍弃小数点后面的小数部分，参数值计算后数据类型必须是数字，否则会报错。

floor函数（最大值）

      对参数值取最大值，如果参数值为小数将四舍五入小数点后面的小数部分，参数值计算后数据类型必须是数字，否则会报错。

chn函数（数字转中文）

       将一个数字转化成中文，参数值计算后数据类型必须是数字，否则会报错。

chn函数使用注意事项chn函数转换数字即可是整数，也可是小数，如果是小数支持后面最多两位小数，如果实际小数过多，chn函数会先进行四舍五入，然后再进行转换。

rmb函数（数字转换为大写的人民币金额）

         将一个数字转换成中文大写的人民币金额，参数值计算后数据类型必须是数字，否则会报错。

rmb函数使用注意事项rmb函数转换数字即可是整数，也可是小数，如果是小数支持后面最多两位小数，如果实际小数过多，rmb函数会先进行四舍五入，然后再进行转换。

cos函数（求余弦）

       求参数的余弦值，参数值计算后数据类型必须是数字，否则会报错。

sin函数（正弦）

       求参数的正弦值，参数值计算后数据类型必须是数字，否则会报错。

tan函数（正切）

      求参数的正切值，参数值计算后数据类型必须是数字，否则会报错。

exp函数（方法用于返回自然数底数e的参数次方）

       求参数的自然数底数e的参数次方，参数值计算后数据类型必须是数字，否则会报错。

log10函数（返回以10为底的对数值）

       求参数以10为底的对数值，参数值计算后数据类型必须是数字，否则会报错。

log函数（自然对数）

       求参数自然对数值，参数值计算后数据类型必须是数字，否则会报错。

median函数（中位数）

        求一组数据的中位数，参数值计算后数据类型必须是数字，否则会报错。

mode函数（众数）

        求一组数据的众数，参数值计算后数据类型必须是数字，否则会报错。

vara函数（方差）

        求一组数据的方差，参数值计算后数据类型必须是数字，否则会报错。

stdevp函数（标准差）

        求一组数据的标准差，参数值计算后数据类型必须是数字，否则会报错。

pow函数（返回第一个参数的第二个参数次方）

pow函数需要两个参数，第一个为需要计算的数字或表达式，第二个为具体的次方。

random函数（随机数）

生成一个随机数，可以有一个数字类型的参数或表达式，如果有参数，那么以这个参数作为生成随机数字的种子，如果没有则生成一个0~1之间的随机数。

round函数（四舍五入）

对一个小数进行四舍五入，它需要两个参数，第一个参数要进行四舍五入的小数或表达式，第二个为

一个可选的

要保留的小数位数，如果没有，则不保留小数。

sqrt函数（平方根）

求一个数字或表达式计算后值的平方根，参数值计算后数据类型必须是数字，否则会报错。

日期函数

date函数（日期）

输出日期，date函数可以有一个参数，就是日期格式，如果没有则采用yyyy-MM-dd HH:mm:ss格式输出日期。

day函数（天）

输出当前在月份中的天，该函数没有参数。

month函数（月） 

输出当前月份，该函数没有参数。 

week函数（星期）

输出当前是星期几，该函数没有参数。

year函数（年） 

输出当前年份，该函数没有参数

字符串函数

indexOf函数(位置)

      用于返回一个字符串，在目标字符串中的位置，该函数至少需要两个参数，第一个为目标字符串，第二个为要查找的字符串，如果有三个参数，那么第三个就是开始查找的位置信息，第三个参数必须是一定大于等于0的数字。

length函数（长度）

       求目标字符串长度，该函数必须要有一个参数。

lower函数（转小写）

  将参数中英文全部转为小写，该函数必须要有一个参数。

upper函数（转大写）

  将参数中英文全部转为大写，该函数必须要有一个参数。

replace函数（替换字符串）

这个函数需要有三个参数，第一个是目标字符串，第二个是要被替换的字符串，第三个是要替换的字符串。

substring函数（子字符串）

       该函数允许有三个参数，第一个是目标字符串，第二个为开始截取的位置，第三个为截取结束的位置。

trim函数（去空格）

       去除目标字符串两边空格，该函数要求必须要有一个参数。

json函数（解析JSON字符串）

      json函数是2.1.3版本新增的，该函数可以解析指定的目标JSON字符串，并取出指定的属性值。json函数需要有两个参数，第一个是目标JSON字符串对象，第二个是要取出的属性名。

对JSON字符串的要求json函数在解析JSON字符串时，要求必须是标准的JSON字符串，比如下面这样的：{"name":"superman","age":32,"company":{"name":"bstek","address":"SHANGHAI CHINA"}}也就是key属性也需要用“”包裹的，如果是下面这种类型的JSON字符串就解析时就会产生错误：{name:"superman",age:32,company:{name:"bstek",address:"SHANGHAI CHINA"}}