润乾报表常用函数

润乾报表常用函数

函数说明： 生成一组连续的整数数据

语法： to(startExp,endExp{,stepExp})

参数说明：

startExp 整数数据开始的表达式

endExp 整数数据结束的表达式

stepExp 整数数据步长的表达式

函数示例：

to(1,5)=list(1,2,3,4,5)

to(1,5,2)=list(1,3,5)

to(-5,-10,-2)=list(-5,-7,-9)

to(-10,-8)=list(-10,-9,-8)

函数说明：从数据集的当前行集中选取符合条件的记录

语法：

( {, desc_exp{, filter_exp{,

sort_exp{,rootGroupExp}}}} )

( , , )//适用于不需排序或数据集中已排好序

参数说明：

select_exp： 要选择的字段列名/列号，，也可以是表达式。 列号用#n表示，例如#0代表第0列，#1代表第1列，依此类推

desc_exp: 指定数据排序的顺序，true表示降序排列，false表示升序排列。

filter_exp: 数据过滤表达式，如果全部选出，则此参数省略，仅用“,”占位。

sort_exp: 数据排序表达式。当此项为空时先检查desc_exp是否为空，如果为 空，则不排序，否则使用select_exp排序。 rootGroupExp 是否root数据集表达式

返回值： 一组数据的集合，数据类型由select_exp的运算结果决定 函数示例：

例1：( name ) 从数据源ds1中选取name字段列的所有值,

不排序

例2：( #2, true ) 从数据源ds1中选取第二个字段列的所有值并降序排列

例3：( name,false,sex=='1') 从数据源ds1中选取性别为男性的name字段列的值并升序排列

例4：( name, true, sex=='1', id ) 从数据源ds1中选取性别为男性的name字段列的值并按id字段降序排列

函数说明：将字符串或数字转换成整数

语法： int( string ) int( number )

参数说明：

string 需要转换的字符串表达式

number 数字，如果带有小数位，转换后小数位被截掉

返回值： 32位整数

示例:

例1：int( "100" ) 返回：100

例2：int( 100.1 ) 返回：100

例3：int(100.9999) 返回：100

函数说明

显示值对照表函数，从对照表中找出当前单元格对应值的显示值，没有则返回null

语法： map(valueListExp, displayListExp)

参数说明：

valueListExp 真实值列表，可以是可扩展单元格或结果为集合列表的表达式

displayListExp 显示值列表，可以是可扩展单元格或结果为集合列表的表达式 真实值列表和显示值列表一一对应

返回值： 字符型，和当前格真实值对应的显示值

示例：

例1：map(to(1,3),list("男","女","不定"))

例2：map(arg1,arg2) 其中arg1为1,2,3组成的参数组，arg2为"男","女","不定"组成的字符串组

例3：map(list(1,2,3),list("男","女","不定"))

1函数说明：从数据集中按顺序检索到符合过滤条件的第一条记录， 返回其selectExp值

语法： 1(selectExp{,filterExp{,rootGroupExp}})

参数说明： selectExp 要选择的字段列名/列号，，也可以是表达式。 列号用#n表示，例如#0代表第0列，#1代表第1列，依此类推 filterExp 过滤条件 rootGroupExp 是否root数据集表达式

返回值： 数据类型不定，由selectExp的运算结果决定

特别说明： 当对数据集运用过滤条件后确定只剩一条记录时，虽然select的运算结果一样，但是select1运算效率高，因为他只要找到符合条件的记录，就不继续检索了，而select要检索完所有的记录才返回。

示例：

例1：1(name) 返回数据集ds1中第一条记录的name字段值

例2：1(name,score>90) 从数据集ds1中检索出成绩大于90的记录，返回第一条记录的name字段值

函数说明：取得当前单元格的值

语法： value()

返回值： 当前单元格的值

函数说明:取得当前页的页码，注意，本函数只是在分页后才有效

语法： pno({booleanExp})

参数说明： booleanExp 表达式

返回值： 当前页的页码。

函数示例：

pno() 返回前页在总的页表中的页码

pno(true) 返回前页在纵向分页的页表中的页码

pno(false) 返回前页在横向分页的页表中的页码

：计算分页后的当前页中所有的单元格(cellExp)的和，注意，本函 数只是在分页后才有效

语法： pcsum({cellExp})

参数说明： cellExp 表达式

返回值： 当前页中所有的单元格(cellExp)的和

函数示例： pcsum(A2{条件}) 返回当前页中所有的A2格之和

t函数说明：计算分页后的当前页中所有的单元格(cellExp)的个

数，注意，本函数只是在分页后才有效

语法： pccount({cellExp})

参数说明： cellExp 表达式

返回值： 当前页中所有的单元格(cellExp)的个数

函数示例： pccount(A2{条件}) 返回当前页中所有的A2格的个数

函数说明：获得系统此刻的日期时间

语法： now()

返回值： 日期时间

函数说明

根据布尔表达式的不同计算结果，返回不同的值。本函数从左到右计算，先出现的 布尔表达式先算，如果出现为true的表达式，则返回相应的结果，后面的不再计算。 如果没有一个布尔表达式为true,而且有缺省值表达式，则返回缺省值，否则返回null。

语法： if(boolExp1,valueExp1{,boolExp2,valueExp2

{,boolExp3,valueExp3 {, {defaultExp}}}})

参数说明：

boolExp(n) 布尔表达式，如果结果为真，则返回对应的值表达式计算结果

valueExp(n) 值表达式，和布尔表达式一一对应

defaultExp 缺省值表达式，如果所有布尔表达式结果都为假，则返回本表达式计算结果

返回值： 数据类型不定，由valueExp(n)的运算结果决定。

示例：

例1：if(value()>100,-65536,value()<=100 and

value()>80,-16776961,-14336 ) 表示当前格的值大于100时，返回-65536颜色值，当前格的值小于等于100且大于80时，返回-16776961颜色值，否则返回-14336颜色值

函数说明:取得当前单元格所在行的行号

语法： row({cellExp})

参数说明: cellExp 单元格表达式(不写表示当前单元格)

返回值： 整数

举例： 在第三行单元格中写入=row()，返回值为3，如果第三行存在纵向扩展格，则行号依次改变。

函数说明：根据分组表达式，从数据集中选出一组组集

语法： (

(selectExp{,descExp{,filterExp{,sortExp{,groupSortExp{,groupDescExp{,rootGroupExp}}}}}})

参数说明： selectExp 选出的分组表达式，可以是字段列名/列号，也可以是表达式。 列号用#n表示，例如#0代表第0列，#1代表第1列，依此类推 descExp 分组前记录的排序顺序，true为逆序，false为顺序

filterExp 过滤表达式 sortExp 分组前记录的排序依据表达式

groupSortExp 分组后对组的排序表达式，一般是汇总运算的表达式，如组合计等 groupDescExp 组排序顺序，true为逆序，false为顺序

rootGroupExp 是否root数据集表达式

返回值： 一组数据的集合，数据类型由selectExp的运算结果来决定

示例：

例1：(class) 把数据集ds1中所有记录按照class字段进行分组， 并返回每组的class值组成的集合

例2：(class, true ) 把数据集ds1中所有记录按照class字段降序排列，然后根据class进行分组， 并返回每组的class值组成的集合

例3：(class,false,sex=='1') 从数据源ds1中选取性别为"1"的记录，按照class字段升序排列， 然后根据class进行分组，并返回每组的class值组成的集合

例4：(class, true, sex=='1', id ) 从数据源ds1中选取性别为"1"的记录，按照id字段降序排列， 然后根据class进行分组，并返回每组的class值组成的集合

例5：(省份,true,,,sum(工业产值),true) 对数据集ds1按照省份进行分组，分组后求出每组的sum(工业产值)， 然后按照这个汇总值对组进行逆序排列

函数说明： 对可扩展单元格或集合表达式进行计数

语法： count(expression{,containNull})

参数说明：

expression 需要被计数的单元格或表达式，一般为可扩展单元格或集合表达式

containNull 缺省为true，表示对null元素也进行计数；false则相反

返回值： 整数

示例：

例1：count(A1:B10,false) 以当前格为基格计算A1和B10之间总共有几个单元格，如果单元格的值为空则不进行计数

例2：count(A1[1]:B10[3])计算A1扩展出来的第一个格和B10扩展出来的第三个格之间总共有几个单元格

例3：count(arg1) 其中arg1是参数组，统计arg1中有几个数据

例4：count(B1{})表示求得当前主格扩展区域内所有扩展后的B1单元格的个数

例5：count(B1{`0}{})表示求得根坐标下所有扩展后的B1单元格的个数

函数说明：获得一个枚举的数据集合

语法： list(valueExp1{,valueExp2{,valueExp3{,……}}})

参数说明： valueExp(n) 可以是常数或表达式，也可以是集合表达式 返回值： 一组枚举数据的集合

示例：

例1：list(1,3,5,7,9)

例2：list("abc","def","ghj")

例3：list(arg1,to(1,3),"a","b","c") 假设arg1是个整数组，其值为7,8,9，

那么该表达式的结果值为{7,8,9,1,2,3,"a","b","c"}

单元格函数说明：对可扩展单元格或集合表达式进行求和

语法： sum(expression) sum(cellExp,exp)

参数说明： expression 需要被求和的单元格或表达式，一般为可扩展单元格或集合表达式 cellExp 单元格或单元格集合，以cellExp里的单元格为当前格计算表达式exp exp 表达式

返回值： 实数或者字符型，由被汇总的单元格数据类型决定

示例： 例1：sum(A1:A10) 求出单元格A1至A10的合计值，被统计单元格可以是数值型也可以是字符型

例2：sum(arg1) 其中arg1是参数组，求出arg1中所有元素的合计值

例3：sum(B1{})表示求得当前主格扩展区域内所有扩展后的B1单元格的合计值

例4：sum(B1[`0]{}) 表示求得根坐标下所有扩展后的B1单元格的合计值

例5：sum(A1[`0]{},B1+C1) 计算分别与每个A1相对应的B1、C1的和的合计值

默认汇总规则的格式：sum(cell{})。

函数说明:将字符串转换成日期型数据 语法： date(stringExp)

参数说明： stringExp 字符串表达式，其结果必须返回合法日期格式的字符串 要求格式为yyyy-MM-dd，不含时间，如果含了时间，时间部分不转换

返回值： 日期时间型，但是时间部分都为00:00:00

示例：

例1：date("1982-08-09") 返回日期：1982-08-09 00:00:00

例2：date("1982-08-09 10:20:30") 返回日期：1982-08-09 00:00:00

t函数说明:从数据集的当前行集中选取符合条件的记录,选出字段相 同的行将会只保留第一行

语法： t( {,

filter_exp{,rootGroupExp}} )

参数说明： select_exp 要选择的字段列名/列号，，也可以是表达式。 列号用#n表示，例如#0代表第0列，#1代表第1列，依此类推 filter_exp

数据过滤表达式，如果全部选出，则此参数省略，仅用“,”占位。

rootGroupExp 是否root数据集表达式

返回值： 一组数据的集合，数据类型由select_exp的运算结果决定 函数

示例： 例1：t( name ) 从数据源ds1中选取name字段列的所有值，name相同的纪录只会保留第一个

函数说明：动态解析并计算表达式

语法： eval( StringExp ) eval( StringExp, SubRptExp )

eval( StringExp, DataSetExp )

参数说明： StringExp 待计算的表达式串 SubRptExp 嵌入式子报表对象，一般是含有子报表的单元格 DataSetExp 数据集对象，一般是ds函数

函数示例：

例1：eval( "1+5" ) 返回6

例2：( eval("id > 1 and id < 10") ) 返回数据集ds1中id大于1且小于10的记录个数 特殊使用:

例3：eval("B2+10", A1)或eval("B2",A1)+10，其中A1为嵌入式子报表，表示计算A1子报表中的B2+10

例4：eval("salary+100", ds("ds1"))，表示计算数据集ds1中salary加100，它与eval("+100")等效

数据集函数说明：计算数据集当前记录行集中，满足条件的记录数

语法：

({filterExp{,rootGroupExp{,nullCheckExp}}})

参数说明： filterExp 条件表达式，如果全部选出，则不要此参数，

rootGroupExp 是否root数据集表达式 nullCheckExp 检查某一条记录是否为空的标达式

返回值： 整数

举例：

例1：() 表示对ds1中当前记录行集中所有记录进行计数，返回记录数。

例2：(true) 含义同上，但是运算速度比()慢，因此当记录全部选出时， 建议不要true

例3：(quantity>500) 表示从ds1当前记录行集中选出quantity>500的记录进行计数， 返回记录数。

例4：(,,ID) 表示当前记录行集中ID不为空的纪录数目

数据集函数说明：从数据集当前记录行集中检索出符合条件的记录集

合，算出给定字段或表达式的汇总值

语法： (selectExp{,filterExp{,rootGroupExp}})

参数说明： selectExp 需求和的字段或表达式 filterExp 条件表达式

rootGroupExp 是否root数据集表达式

返回值： 实数

示例：

例1：(quantity) 求得数据集ds1当前行集中quantity字段的汇总值

例2：(quantity,productid=="1") 从数据集ds1当前行集中检索出productid="1"的记录集，求得其quantity字段的汇总值

oup函数说明： 根据表达式的不同计算结果，返回不同的值,然 后按这些值进行分组

本函数:从左到右计算，先出现的表达式先算，如果出现满足的表达式，则返回相应的结果，后面的不再计算。如果没有一个表达式满足条件,而且有缺省值表达式，则返回缺省值，否则返回null。

语法：

oup({hasNullGroup{,termExp1,resultExp1{,term2,resultExp2{,...{,defaultExp}}}}})

参数说明：

hasNullGroup 布尔表达式，true返回空组，false不返回空组

termExp(n) 条件表达式

resultExp(n) 返回结果表达式

defaultExp 缺省值表达式，如果所有表达式结果都不满足，则返回本表达式计算结果

返回值： 一组数据的集合，数据类型由resultExp1的运算结果决定

函数示例：

例1：oup(true,类别ID==1 or 类别ID==3,"副食品",类别ID==6,"肉类","其他")

将数据集中满足类别ID==1 or 类别ID==3的记录归到“副食品”组中，满足类别ID==6的记录归到“肉类”组中，其他的记录归到“其他”组中

p函数说明： 对每一条记录依次计算条件表达式，如果满足则把 该条记录加入到相应的组里。如果有多个组满足，则这些组中都会含有此条 记录。如果都不满足并且有缺省值表达式，则把该条记录加入到缺省组中。 组值为以该组的第一条记录计算结果表达式所得到的值。

语法：

p({hasNullGroup{,termExp1,resultExp1{,term2,resultExp2{,...{,defaultExp}}}}})

参数说明：

hasNullGroup 布尔表达式，true返回空组，false不返回空组

termExp(n) 条件表达式

resultExp(n) 返回结果表达式

defaultExp 缺省值表达式，如果所有表达式结果都不满足，则返回本表达式计算结果

返回值： 一组数据的集合，数据类型由resultExp1的运算结果决定

函数示例：

例1：p(true,货主地区=="华北","华北",货主城市=="北京"," 其中：北京",货主地区=="华南","华南",货主地区=="华中","华中","其他")

把数据集中满足“货主地区=="华北"”的记录归到"华北"组中，满足“货主城市=="北京"”的记录归到" 其中：北京"组中，满足“货主地区=="华南"”的记录归到"华南"组中，满足“货主地区=="华中"”的记录归到"华中"组中，剩余的记录归到"其他"组中。

函数说明: 计算一个值在一个完全划分中的位置

语法: plot( valueExp, ListExp{, eqExp}{, ascExp} )

参数说明：

valueExp 返回值的表达式，值可以是字符串、数值、日期、时间等

ListExp 返回同valueExp数据类型相同的数组，要求其中元素从小到大排列

eqExp 返回布尔值的表达式，缺省为false，为false表示与ListExp元素比较时不包含等于

ascExp 返回布尔值的表达式，缺省为true，即表示ListExp中元素从小到大排列，否则为从大到小排列

示例:

例1：plot( 0, list(0,10,100) ) 返回1，第一个集合为<0，不包含0，第二个集合为>=0且<10，所以0落在了第二个集合中，集合的编号从0开始起编，依次为0,1,2,3，所以结果为1

例2：plot( 0, list(0,10,100),true,true) 返回0

例3：plot( 10, list(0,10,100), false ) 返回2

例4：plot(10,list(100,10,0),true,false) 返回1

详细说明： 划分是指将一个集合划分成几个集合，如数组{0,10,100}在eqExp返回false的情况下将整数集或实数集划分成4个集合，依次分别是<0、<10(此集合中元素必定>=0)、<100(此集合中元素必定>=10)及其它(即>=100)； 在eqExp返回true的情况下将整数集或实数集划分成4个集合，分别是<=0、<=10(且>0)、<=100(且>10)及其它(即>100)； 对于数组{100,10,0}，eqExp为false时也划分成4个集合，分别为>100,>10(且<=100),>0(且<=10)及其它(即<=0); eqExp为true时则为>=100,>=10(且<100),>=0(且<10)及其它(即<0)