润乾报表常用函数.doc

润乾常用函数数值计算函数说明：abs(numberExp) 计算参数的绝对值 语法： abs(numberExp) 参数说明： numberExp 待计算绝对值的数据 返回值： 数值型 示例： 例1：abs(-3245.54) 返回：3245.54 例2：abs(-987) 返回：987函数说明：cos(numberExp) 计算参数的余弦值，其中参数以弧度为单位 相关的函数有sin() 计算参数的正弦值 tan() 计算参数的正切值 语法： cos(numberExp) 参数说明： numberExp 待计算余弦值的弧度数 返回值：double型 示例： 例1：cos(pi() 返回：-1 例2：cos(pi(2) 返回：1函数说明：eval( StringExp ) 动态解析并计算表达式 语法： eval( StringExp ) eval( StringExp, SubRptExp ) eval( StringExp, DataSetExp ) 参数说明： StringExp 待计算的表达式串 SubRptExp 嵌入式子报表对象，一般是含有子报表的单元格 DataSetExp 数据集对象，一般是ds函数 返回值：表达式的结果值，数据类型由表达式决定 示例： 例1：eval( 1+5 ) 返回6 例2：eval(B2+10, A1) 其中A1为嵌入式子报表，表示计算A1子报表中的B2+10 例3：eval(salary+100, ds(ds1) 表示计算数据集ds1中salary加100函数说明：exp(nExp) 计算e的n次幂 语法： exp(nExp) 参数说明： nExp 指定次幂数 返回值：数值型 示例： 例1：exp(4.3) 返回：73.69979369959579函数说明：fact(nExp) 计算参数的阶乘 语法： fact(nExp) 参数说明： nExp 待计算阶乘的数据 返回值：长整数（64位） 示例： 例1：fact(10) 返回：3628800函数说明：fill(s, n) 获得n个s拼成的字符串 相关函数：space() 产生一个空串 语法： fill(s, n) 参数说明： s 用于拼成新串的源串 n 新串中包含源串的个数 返回值：字符型 示例： 例1：fill(1 ,10) 返回：1 1 1 1 1 1 1 1 1 1 例2：fill(a b,10) 返回：a ba ba ba ba ba ba ba ba ba b函数说明：float(string) 将单精度浮点数、双精度浮点数、字符串转换为32位的单精度浮点型 语法： float(string) float(number) 参数说明： string 需要转换的单精度浮点数、双精度浮点数表达式 number 数字 返回值：32位的单精度浮点数 示例： 例1：float(1234567) 返回：1234567.0 例2：float(1234567.0) 返回：1234567.0 例3：float(1234567) 表达式提示错误，因为1234567不是浮点数函数说明：floor(numberExp, nExp) 对数据在指定位置上进行截取，剩余部分只要有值全舍去 相关的函数有: ceil:对数据在指定位置上进行截取，剩余部分只要有值就进位 round:对数据在指定位置上进行截取，剩余部分四舍五入 语法： floor(numberExp, nExp) 参数说明： numberExp 需要进行截取的数据 nExp 整数，用于指定需要进行截取的位置， 0：从小数点往右位移nExp个位数， 0：从小数点往右位移nExp个位数， 0：从小数点往左移nExp个位数 =0：表示当前小数点的位置 返回值：数值型 示例： 例1：=round(3451251.274,0) 返回：3451251.0 例2：=round(3451251.274,-1) 返回：3451250.0 例3：=round(3451251.274,-2) 返回：3451300.0 例4：=round(3451251.274,1) 返回：3451251.3 例5：=round(3451251.274,2) 返回：3451251.27函数说明：sin(number) 计算参数的正弦值，其中参数以弧度为单位 相关的函数有cos() 计算参数的余弦值 tan() 计算参数的正切值 语法： sin(number) 参数说明： number 需要计算正弦值的弧度数 返回值：double型 示例： 例1：sin(pi() 返回：1.2246467991473532E-16 例2：sin(pi(2) 返回：-2.4492935982947064E-16 例3：sin(pi()/2) 返回：1.0函数说明：sqrt(number) 计算平方根 语法： sqrt(number) 参数说明： number 需要计算平方根的数据 返回值： 数值型 示例： 例1：sqrt(100) 返回：10.0 例2：sqrt(99) 返回：9.9498743710662函数说明：tan(number) 计算参数的正切值，其中参数以弧度为单位 相关的函数有sin() 计算参数的正弦值 cos() 计算参数的余弦值 语法： tan(number) 参数说明： 需要计算正切值的弧度数 返回值：double型 示例： 例1：tan(pi()/2) 返回：1.633123935319537E16 例2：tan(pi(2) 返回：-2.4492935982947064E-16函数说明：sum(expression) 对可扩展单元格或集合表达式进行求和 语法： 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的和的合计值日期函数说明：age(dateExp,typeExp) 计算从参数定义的时间到当前间隔的整年数 语法： age(dateExp,typeExp) age(stringExp,formatExp,typeExp) 参数说明： dateExp 日期型表达式，运算的结果是日期型(Date) stringExp 表达式，其结果必须为日期或中国日期时间格式的字符串 formatExp 格式化表达式比如yyyyMMdd,yyyy-MM-dd等 typeExp 计算精确的最小单位 1为日，2为月，3为年，缺省为日 返回值： 整数 示例： 假设今天为2007.1.1 例1：age(datetime2(19800227,yyyyMMdd) 结果为26 例3：age(19800227,yyyyMMdd,3) 结果为27函数说明：date(stringExp) 将字符串转换成日期型数据 语法： 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函数说明：dateTime(string) 将字符串或长整数转换成日期时间 语法： dateTime(string) dateTime(long) 参数说明： string 格式为yyyy-MM-dd HH:mm:ss的字符串 long 以微秒计的长整数 返回值：日期时间 示例： 例1：dateTime(2006-01-01 10:20:30) 返回：2006-01-01 10:20:30 例2：dateTime(2006-01-01 10:20:30:111) 返回：2006-01-01 10:20:30 例3：dateTime(12345) 返回：1970-01-01 08:00:12函数说明：datetime2(string, format) 将各种格式的日期字符串转换成日期时间型数据，转换时可以指定字符串的当前格式 语法： datetime2(string, format) 参数说明： string 各种格式的日期字符串 format 用于说明参数1的格式串 返回值：日期时间型数据 示例： 例1：datetime2(12/28/1972,MM/dd/yyyy) 返回：1972-12-28 00:00:00 例2：datetime2(12/28/1972 10:23:43,MM/dd/yyyy hh:mm:ss) 返回：1972-12-28 10:23:43 例3：datetime2(19800227,yyyyMMdd) 返回：1980-02-27 00:00:00 例4：datetime2(1982年12月30日,yyyy年MM月dd日) 返回：1982-12-30 00:00:00函数说明：day(dateExp) 从日期型数据中获得该日在本月中是几号 语法： day(dateExp) 参数说明： dateExp 表达式，其结果必须为日期或中国日期时间格式的字符串 返回值：整数 示例： 例1：day(datetime2(19800227,yyyyMMdd) 返回：27 例2：day(dateTime(12345) 返回：1 例3：day(dateTime(2006-01-15 10:20:30) 返回：15函数说明：dayName(dateExp) 从日期型数据中获得该日的星期名称 语法： dayName(dateExp) 参数说明： dateExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss，yyyy-MM-dd，HH:mm:ss 返回值：字符型 示例： 例1：dayName(datetime2(19800227,yyyyMMdd) 返回：星期三 例2：dayName(dateTime(12345) 返回：星期四 例3：dayName(dateTime(2006-01-15 10:20:30) 返回：星期日 例4：dayName(12:14:34) 返回：星期四 例5：dayName(1972-11-08) 返回：星期三 例6：dayName(1972-11-08 10:20:30) 返回：星期三函数说明：dayNo(dateExp) 从日期型数据中，获得该日位于一个星期中的第几天，星期天返回1，星期一返回2，依此类推 语法： dayNo(dateExp) 参数说明： dateExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss，yyyy-MM-dd，HH:mm:ss 返回值： 整数 示例： 例1：dayNo(dateTime2(19800227,yyyyMMdd) 返回：4 例2：dayNo(dateTime(2006-01-15 10:20:30) 返回：1 例3：dayNo(1972-11-08 10:20:30) 返回：4函数说明：daysAfter(dateExp1, dateExp2) 计算两个日期型数据相差几天 语法： daysAfter(dateExp1, dateExp2 参数说明： dateExp1 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss，yyyy-MM-dd，HH:mm:ss dateExp2 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss，yyyy-MM-dd，HH:mm:ss 返回值：整数 示例： 例1：daysAfter(dateTime(1983-12-15 10:20:30),datetime2(1982年12月30日,yyyy年MM月dd日) 返回：-350 例2：daysAfter(1983-12-15 10:20:30,1982-12-30) 返回：-350函数说明：daysInMonth(dateExp) 获得指定日期所在月的天数 语法： daysInMonth(dateExp) 参数说明： dateExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss，yyyy-MM-dd，HH:mm:ss 返回值：整数 示例： 例1：daysInMonth(datetime2(19800227,yyyyMMdd) 返回：29 例2：daysInMonth(1972-11-08 10:20:30) 返回：30 例3：daysInMonth(dateTime(2006-01-15 10:20:30) 返回：31函数说明：daysInYear(dateExp) 获得指定日期所在年或者指定年份的天数 语法： daysInYear(dateExp) daysInYear(year) 参数说明： dateExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss，yyyy-MM-dd，HH:mm:ss year 返回整数的表达式 返回值：整数 示例： 例1：daysInYear(datetime2(19800227,yyyyMMdd) 返回：366 例2：daysInYear(dateTime(2006-01-15 10:20:30) 返回：365 例3：daysInYear(1972-11-08 10:20:30) 返回：366 例4：daysInYear(2006) 返回：365函数说明：hour(datetimeExp) 从日期时间型数据中，获得当前时间位于一天中的第几个时辰 语法： hour(datetimeExp) 参数说明： datetimeExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss，yyyy-MM-dd，HH:mm:ss 返回值：整数 示例： 例1：hour(1983-12-15) 返回：0 例2：hour(1983-12-15 10:30:25) 返回：10 例3：hour(dateTime(2006-01-15 13:20:30) 返回：13函数说明：lastday(dateExp) 获得指定日期的上一天 语法： lastday(dateExp) 参数说明： dateExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss，yyyy-MM-dd，HH:mm:ss 返回值：日期时间型 示例： 例1：lastday(1972-11-08 10:20:30) 返回：1972-11-07 10:20:30 例2：lastday(datetime2(19800227,yyyyMMdd) 返回：1980-02-26 00:00:00 例3：lastday(dateTime(2006-01-15 10:20:30) 返回：2006-01-14 10:20:30函数说明：lastmonth( dateExp ) 取得指定日期在上月的同日，若无同一日，则返回上月月末 语法： lastmonth( dateExp ) 参数说明： dateExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss，yyyy-MM-dd，HH:mm:ss 返回值：日期时间型 示例： 例1：lastmonth(datetime2(19800227,yyyyMMdd) 返回：1980-01-27 00:00:00 例2：lastmonth(1972-11-08 10:20:30) 返回：1972-10-08 10:20:30 例3：lastmonth(dateTime(2006-01-15 10:20:30) 返回：2005-12-15 10:20:30函数说明：lastyear( dateExp ) 取得指定日期在去年的同月同日，若无同月同日，则返回去年同月最后一天 语法： lastyear( dateExp ) 参数说明： dateExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss，yyyy-MM-dd，HH:mm:ss 返回值：日期时间型 示例： 例1：lastyear(datetime2(19800227,yyyyMMdd) 返回：1979-02-27 00:00:00 例2：lastyear(1972-11-08 10:20:30) 返回：1971-11-08 10:20:30 例3：lastyear(dateTime(2006-01-15 10:20:30) 返回：2005-01-15 10:20:30函数说明：minute(datetimeExp) 从日期时间型数据中，获得分钟的信息 语法： minute(datetimeExp) 参数说明： datetimeExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss 返回值：整数 示例： 例1：minute(datetime2(19800227,yyyyMMdd) 返回：0 例2：minute(1972-11-08 10:20:30) 返回：20 例3：minute(dateTime(2006-01-15 13:20:30) 返回：20函数说明：month(dateExp) 取得指定日期所在的月份 语法： month(dateExp) 参数说明： dateExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss 返回值：整数 示例： 例1：month(datetime2(19800227,yyyyMMdd) 返回：2 例2：month(1972-11-08 10:20:30) 返回：11 例3：month(dateTime(2006-01-15 13:20:30) 返回：1函数说明：monthbegin( dateExp ) 取得指定日期所在月的月首 语法： monthbegin( dateExp ) 参数说明： dateExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss 返回值： 日期时间型 示例： 例1：monthbegin(datetime2(19800227,yyyyMMdd) 返回：1980-02-01 00:00:00 例2：monthbegin(1972-11-08 10:20:30) 返回：1972-11-01 10:20:30 例3：monthbegin(dateTime(2006-01-15 13:20:30) 返回：2006-01-01 13:20:30函数说明：monthend( dateExp ) 取得指定日期所在月的月末 语法： monthend( dateExp ) 参数说明： dateExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss 返回值：日期时间型 示例： 例1：monthend(datetime2(19800227,yyyyMMdd) 返回：1980-02-29 00:00:00 例2：monthend(1972-11-08 10:20:30) 返回：1972-11-30 10:20:30 例3：monthend(dateTime(2006-01-15 13:20:30) 返回：2006-01-31 13:20:30函数说明：now() 获得系统此刻的日期时间 语法： now() 返回值：日期时间函数说明：quaterbegin( dateExp ) 取得指定日期所在季度的首日 语法： quaterbegin( dateExp ) 参数说明： dateExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss 返回值：日期时间 示例： 例1：quaterbegin(datetime2(19800227,yyyyMMdd) 返回：1980-01-01 00:00:00 例2：quaterbegin(1972-11-08 10:20:30) 返回：1972-10-01 10:20:30 例3：quaterbegin(dateTime(2006-01-15 13:20:30) 返回：2006-01-01 13:20:30函数说明：quaterend( dateExp ) 取得指定日期所在季度的末日 语法： quaterend( dateExp ) 参数说明： dateExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss 返回值：日期时间 示例： 例1：quaterend(datetime2(19800227,yyyyMMdd) 返回：1980-03-31 00:00:00 例2：quaterend(1972-11-08 10:20:30) 返回：1972-12-31 10:20:30 例3：quaterend(dateTime(2006-01-15 13:20:30) 返回：2006-03-31 13:20:30函数说明：relDate(dateExp, nExp) 从给定的日期型数据中，算出相差n天后的新的日期数据 语法： relDate(dateExp, nExp) 参数说明： dateExp 给定的起始日期表达式，其结果必须为日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss nExp 整数表达式，需要求得nExp天后的新日期 返回值：日期时间 示例： 例1：relDate(datetime2(19800227,yyyyMMdd),5) 返回：1980-03-03 00:00:00 例2：relDate(1972-11-08 10:20:30,-10) 返回：1972-10-29 10:20:30 例3：relDate(dateTime(2006-01-15 13:20:30),15) 返回：2006-01-30 13:20:30函数说明：relTime(datetimeExp, nExp) 从给定的日期时间型数据中，算出相差n秒后的新的日期时间数据 语法： relTime(datetimeExp, nExp) 参数说明： datetimeExp 给定的起始日期表达式，其结果必须为日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss nExp 整数表达式，需要求得nExp秒后的新日期时间 返回值：日期时间 示例： 例1：relTime(datetime2(19800227,yyyyMMdd),5) 返回：1980-02-27 00:00:05 例2：relTime(1972-11-08 10:20:30,-10) 返回：1972-11-08 10:20:20 例3：relTime(dateTime(2006-01-15 13:20:30),15) 返回：2006-01-15 13:20:45函数说明：second(datetimeExp) 从日期时间型数据中，获得秒信息 语法： second(datetimeExp) 参数说明： datetimeExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss 返回值：整数 示例： 例1：second(datetime2(19800227,yyyyMMdd) 返回：0 例2：second(1972-11-08 10:20:30) 返回：30 例3：second(dateTime(2006-01-15 13:20:45) 返回：45函数说明：secondsAfter(datetimeExp1,datetimeExp2) 计算两个日期时间型数据相差几秒 语法： secondsAfter(datetimeExp1,datetimeExp2) 参数说明： datetimeExp1 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss datetimeExp2 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss 返回值：整数 示例： 例1：secondsAfter(datetime2(19800227,yyyyMMdd),dateTime(1980-02-27 00:00:45) 返回：45 例2：secondsAfter(1972-11-08 10:20:30,1972-11-08 10:30:50) 返回：620函数说明：time(stringExp) 将字符串转换成时间型数据 语法： time(stringExp) 参数说明： stringExp HH:mm:ss格式的字符串 返回值：时间型数据 示例：函数说明：weekbegin(dateExp) 获得指定日期所在星期的星期天，这里认定星期天为一周的开始 语法： weekbegin(dateExp) 参数说明： dateExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss 返回值：日期时间型 示例： 例1：weekbegin(datetime2(19800227,yyyyMMdd) 返回：1980-02-24 00:00:00 例2：weekbegin(1972-11-08 10:20:30) 返回：1972-11-05 10:20:30 例3：weekbegin(dateTime(2006-01-15 13:20:45) 返回：2006-01-15 13:20:45函数说明：weekend(dateExp) 获得指定日期所在星期的星期六，这里认定星期六为一周的结束 语法： weekend(dateExp) 参数说明： dateExp 日期或标准日期格式的字符串， 如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd