润乾报表常用函数.doc

润乾报表常用函数1.to函数说明： 生成一组连续的整数数据语法： 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)2.select函数说明：从数据集的当前行集中选取符合条件的记录语法：datasetName.select( , desc_exp, filter_exp, sort_exp,rootGroupExp )datasetName.select( , , )/适用于不需排序或数据集中已排好序参数说明：select_exp： 要选择的字段列名/列号，也可以是表达式。 列号用#n表示，例如#0代表第0列，#1代表第1列，依此类推desc_exp: 指定数据排序的顺序，true表示降序排列，false表示升序排列。filter_exp: 数据过滤表达式，如果全部选出，则此参数省略，仅用“,”占位。sort_exp: 数据排序表达式。当此项为空时先检查desc_exp是否为空，如果为 空，则不排序，否则使用select_exp排序。 rootGroupExp 是否root数据集表达式返回值： 一组数据的集合，数据类型由select_exp的运算结果决定 函数示例：例1：ds1.select( name ) 从数据源ds1中选取name字段列的所有值, 不排序例2：ds1.select( #2, true ) 从数据源ds1中选取第二个字段列的所有值并降序排列例3：ds1.select( name,false,sex=1) 从数据源ds1中选取性别为男性的name字段列的值并升序排列例4：ds1.select( name, true, sex=1, id ) 从数据源ds1中选取性别为男性的name字段列的值并按id字段降序排列3.Int函数说明：将字符串或数字转换成整数语法： int( string ) int( number )参数说明：string 需要转换的字符串表达式number 数字，如果带有小数位，转换后小数位被截掉返回值： 32位整数示例:例1：int( 100 ) 返回：100例2：int( 100.1 ) 返回：100例3：int(100.9999) 返回：1004.map函数说明显示值对照表函数，从对照表中找出当前单元格对应值的显示值，没有则返回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(男,女,不定)5.Select1函数说明：从数据集中按顺序检索到符合过滤条件的第一条记录，返回其selectExp值语法： datasetName.select1(selectExp,filterExp,rootGroupExp)参数说明： selectExp 要选择的字段列名/列号，也可以是表达式。 列号用#n表示，例如#0代表第0列，#1代表第1列，依此类推 filterExp 过滤条件 rootGroupExp 是否root数据集表达式返回值： 数据类型不定，由selectExp的运算结果决定特别说明： 当对数据集运用过滤条件后确定只剩一条记录时，虽然select的运算结果一样，但是select1运算效率高，因为他只要找到符合条件的记录，就不继续检索了，而select要检索完所有的记录才返回。示例：例1：ds1.select1(name) 返回数据集ds1中第一条记录的name字段值例2：ds1.select1(name,score90) 从数据集ds1中检索出成绩大于90的记录，返回第一条记录的name字段值6.Value函数说明：取得当前单元格的值语法： value()返回值： 当前单元格的值7.pno函数说明:取得当前页的页码，注意，本函数只是在分页后才有效语法： pno(booleanExp)参数说明： booleanExp 表达式返回值： 当前页的页码。函数示例：pno() 返回前页在总的页表中的页码pno(true) 返回前页在纵向分页的页表中的页码pno(false) 返回前页在横向分页的页表中的页码8.pcsum：计算分页后的当前页中所有的单元格(cellExp)的和，注意，本函数只是在分页后才有效语法： pcsum(cellExp)参数说明： cellExp 表达式返回值： 当前页中所有的单元格(cellExp)的和函数示例： pcsum(A2条件) 返回当前页中所有的A2格之和 9.pccount函数说明：计算分页后的当前页中所有的单元格(cellExp)的个数，注意，本函数只是在分页后才有效语法： pccount(cellExp)参数说明： cellExp 表达式返回值： 当前页中所有的单元格(cellExp)的个数函数示例： pccount(A2条件) 返回当前页中所有的A2格的个数10.now函数说明：获得系统此刻的日期时间语法： now()返回值： 日期时间11.if函数说明根据布尔表达式的不同计算结果，返回不同的值。本函数从左到右计算，先出现的 布尔表达式先算，如果出现为true的表达式，则返回相应的结果，后面的不再计算。 如果没有一个布尔表达式为true,而且有缺省值表达式，则返回缺省值，否则返回null。语法： if(boolExp1,valueExp1,boolExp2,valueExp2 ,boolExp3,valueExp3 , defaultExp)参数说明：boolExp(n) 布尔表达式，如果结果为真，则返回对应的值表达式计算结果valueExp(n) 值表达式，和布尔表达式一一对应defaultExp 缺省值表达式，如果所有布尔表达式结果都为假，则返回本表达式计算结果返回值： 数据类型不定，由valueExp(n)的运算结果决定。示例：例1：if(value()100,-65536,value()80,-16776961,-14336 ) 表示当前格的值大于100时，返回-65536颜色值，当前格的值小于等于100且大于80时，返回-16776961颜色值，否则返回-14336颜色值12.row函数说明:取得当前单元格所在行的行号语法： row(cellExp)参数说明: cellExp 单元格表达式(不写表示当前单元格)返回值： 整数举例： 在第三行单元格中写入=row()，返回值为3，如果第三行存在纵向扩展格，则行号依次改变。13.group函数说明：根据分组表达式，从数据集中选出一组组集语法： datasetName.group( selectExp, , filterExp ) /适用于不需要排序或数据集中已排好序 datasetName.group(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：ds1.group(class) 把数据集ds1中所有记录按照class字段进行分组， 并返回每组的class值组成的集合例2：ds1.group(class, true ) 把数据集ds1中所有记录按照class字段降序排列，然后根据class进行分组， 并返回每组的class值组成的集合例3：ds1.group(class,false,sex=1) 从数据源ds1中选取性别为1的记录，按照class字段升序排列， 然后根据class进行分组，并返回每组的class值组成的集合例4：ds1.group(class, true, sex=1, id ) 从数据源ds1中选取性别为1的记录，按照id字段降序排列， 然后根据class进行分组，并返回每组的class值组成的集合例5：ds1.group(省份,true,sum(工业产值),true) 对数据集ds1按照省份进行分组，分组后求出每组的sum(工业产值)， 然后按照这个汇总值对组进行逆序排列14.count函数说明： 对可扩展单元格或集合表达式进行计数语法： count(expression,containNull)参数说明：expression 需要被计数的单元格或表达式，一般为可扩展单元格或集合表达式containNull 缺省为true，表示对null元素也进行计数；false则相反返回值： 整数示例：例1：count(A1:B10,false) 以当前格为基格计算A1和B10之间总共有几个单元格，如果单元格的值为空则不进行计数例2：count(A11:B103)计算A1扩展出来的第一个格和B10扩展出来的第三个格之间总共有几个单元格例3：count(arg1) 其中arg1是参数组，统计arg1中有几个数据例4：count(B1)表示求得当前主格扩展区域内所有扩展后的B1单元格的个数例5：count(B10)表示求得根坐标下所有扩展后的B1单元格的个数15.list函数说明：获得一个枚举的数据集合语法： 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,c16. Sum单元格函数说明：对可扩展单元格或集合表达式进行求和 语法： 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(B10) 表示求得根坐标下所有扩展后的B1单元格的合计值例5：sum(A10,B1+C1) 计算分别与每个A1相对应的B1、C1的和的合计值默认汇总规则的格式：sum(cell)。17.date函数说明:将字符串转换成日期型数据 语法： 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:0018.dselect函数说明:从数据集的当前行集中选取符合条件的记录,选出字段相同的行将会只保留第一行语法： datasetName.dselect( , filter_exp,rootGroupExp )参数说明： select_exp 要选择的字段列名/列号，也可以是表达式。 列号用#n表示，例如#0代表第0列，#1代表第1列，依此类推 filter_exp 数据过滤表达式，如果全部选出，则此参数省略，仅用“,”占位。 rootGroupExp 是否root数据集表达式返回值： 一组数据的集合，数据类型由select_exp的运算结果决定 函数示例： 例1：ds1.dselect( name ) 从数据源ds1中选取name字段列的所有值，name相同的纪录只会保留第一个19.eval函数说明：动态解析并计算表达式语法： eval( StringExp ) eval( StringExp, SubRptExp ) eval( StringExp, DataSetExp )参数说明： StringExp 待计算的表达式串 SubRptExp 嵌入式子报表对象，一般是含有子报表的单元格 DataSetExp 数据集对象，一般是ds函数函数示例：例1：eval( 1+5 ) 返回6例2：ds1.count( eval(id 1 and id 500) 表示从ds1当前记录行集中选出quantity500的记录进行计数， 返回记录数。例4：ds1.count(,ID) 表示当前记录行集中ID不为空的纪录数目21.sum数据集函数说明：从数据集当前记录行集中检索出符合条件的记录集合，算出给定字段或表达式的汇总值语法： datasetName.sum(selectExp,filterExp,rootGroupExp)参数说明： selectExp 需求和的字段或表达式 filterExp 条件表达式 rootGroupExp 是否root数据集表达式返回值： 实数示例：例1：ds1.sum(quantity) 求得数据集ds1当前行集中quantity字段的汇总值例2：ds1.sum(quantity,productid=1) 从数据集ds1当前行集中检索出productid=1的记录集，求得其quantity字段的汇总值22.enumGroup函数说明： 根据表达式的不同计算结果，返回不同的值,然后按这些值进行分组本函数:从左到右计算，先出现的表达式先算，如果出现满足的表达式，则返回相应的结果，后面的不再计算。如果没有一个表达式满足条件,而且有缺省值表达式，则返回缺省值，否则返回null。语法： ds.enumGroup(hasNullGroup,termExp1,resultExp1,term2,resultExp2,.,defaultExp)参数说明：hasNullGroup 布尔表达式，true返回空组，false不返回空组termExp(n) 条件表达式resultExp(n) 返回结果表达式defaultExp 缺省值表达式，如果所有表达式结果都不满足，则返回本表达式计算结果返回值： 一组数据的集合，数据类型由resultExp1的运算结果决定函数示例：例1：ds1.enumGroup(true,类别ID=1 or 类别ID=3,副食品,类别ID=6,肉类,其他)将数据集中满足类别ID=1 or 类别ID=3的记录归到“副食品”组中，满足类别ID=6的记录归到“肉类”组中，其他的记录归到“其他”组中23.overLap函数说明： 对每一条记录依次计算条件表达式，如果满足则把该条记录加入到相应的组里。如果有多个组满足，则这些组中都会含有此条记录。如果都不满足并且有缺省值表达式，则把该条记录加入到缺省组中。组值为以该组的第一条记录计算结果表达式所得到的值。语法： ds.overlap(hasNullGroup,termExp1,resultExp1,term2,resultExp2,.,defaultExp)参数说明：hasNullGroup 布尔表达式，true返回空组，false不返回空组termExp(n) 条件表达式resultExp(n) 返回结果表达式defaultExp 缺省值表达式，如果所有表达式结果都不满足，则返回本表达式计算结果返回值： 一组数据的集合，数据类型由resultExp1的运算结果决定函数示例：例1：ds1.overlap(true,货主地区=华北,华北,货主城市=北京, 其中：北京,货主地区=华南,华南,货主地区=华中,华中,其他)把数据集中满足“货主地