润乾报表函数

示例：
例1：seco[color=darkred][/color]nd(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)

参数说明：
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




函数说明：
取得指定扩展单元格的同源号，即扩展格扩展后，将此单元格的同源格按行（列）号从小到大排序后
此单元格所在的序号。

语法：
seq({cellExp})
参数说明:
cellExp 单元格表达式，必须返回扩展格
返回值：
整数

举例：
假设A1是扩展格，B1的主格为A1，在B1单元格中写入=seq(A1)，则扩展后B1的值将依次从1变到A1扩展
出来的单元格的数目。



函数说明：
确定参数是正数还是负数还是0，当正数时返回1，负数时返回-1，0时返回0

语法：
sign(number)

参数说明：
number 需要判断正负的数据

返回值：
整数

示例：
例1：sign(-10) 返回：-1

例2：sign(30) 返回：1

例3：sign(0) 返回：0



函数说明：
计算参数的正弦值，其中参数以弧度为单位
相关的函数有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





函数说明：
对数组进行排序

语法：
sort( arrayExp{, boolExp} )

参数说明:
arrayExp 数组表达式，譬如group，select，list等函数
boolExp 布尔表达式，true表示对数组按升序排列，否则降序

返回值：
数组，元素数据类型由参数1决定

示例：
例1：sort({5,2,3,4},true) 返回值为{2,3,4,5}

例2：sort({5,2,3,4}) 返回值为{5,4,3,2}



函数说明：
产生一个空串
相关函数：fill() 获得n个s拼成的字符串

语法：
space(n)

参数说明：
n 生成空串的长度

返回值：
字符串型，获得n个空格拼成的字符串

示例：
例1：space(5) 返回：" "



函数说明：
将字符串按分割符分割成多个子串

语法：
split( srcExp,sepExp{,boolExp})

参数说明：
srcExp 待分割的字符串表达式
sepExp 分隔符表达式
boolExp bool型，是否解析引号、括号里的分隔符，
为true时解析，为false时不解析，缺省为false

返回值：
分割后的字符串列表

示例：
例1：=split("ab;cd;ef;tg;tt",";") 返回数组：["ab","cd","ef","tg","tt"]

例2：=split("ab;c'd;e'f;tg;tt",";",false) 返回数组：["ab","c'd;e'f","tg","tt"]　不解析引号里的分隔符

例3：=split("ab;c[d;e]f;tg;tt",";",false) 返回数组：["ab","c[d;e]f","tg","tt"]　不解析括号里的分隔符

例4：=split("ab;c'd;e'f;tg;tt",";",true) 返回数组：["ab","c'd","e'f","tg","tt"]　解析引号里的分隔符

例5：=split("ab;c[d;e]f;tg;tt",";",true) 返回数组：["ab","c[d","e]f","tg","tt"]　解析括号里的分隔符



函数说明：
计算平方根

语法：
sqrt(number)

参数说明：
number 需要计算平方根的数据

返回值：
数值型

示例：
例1：sqrt(100) 返回：10.0

例2：sqrt(99) 返回：9.9498743710662





函数说明：
将对象转换成字符型，转换过程中可以进行格式化

语法：
str(expression{, format})

参数说明：
expression 需要转换成字符串的常数对象或表达式
format 转换过程中进行格式化的格式串

返回值：
字符型

示例：
例1：str(123) 返回值："123"

例2：str(arg1,"yyyy年MM月dd日")，其中arg1为日期型参数，值为1972-09-09，
返回值："1972年09月09日"

例3：str(3456.9876,"￥#,##0.00") 返回值："￥3,456.99"





函数说明：
获得一个集合的子集合

语法：
subList(srcList,startPos,count)

参数说明：
srcList 源集合表达式
startPos 起始索引，从0开始计数
count 返回的元素数目

返回值：
集合的子集合

示例：
例1：subList( list(1,3,5,7,9), 1, 2 ) 结果为{ 3, 5 }




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

语法：
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的和的合计值





函数说明：
计算参数的正切值，其中参数以弧度为单位
相关的函数有sin() 计算参数的正弦值
cos() 计算参数的余弦值
语法：
tan(number)

参数说明：
需要计算正切值的弧度数

返回值：
double型

示例：
例1：tan(pi()/2) 返回：1.633123935319537E16

例2：tan(pi(2)) 返回：-2.4492935982947064E-16



函数说明：
抛出一个ReportError异常

语法：
throwe({msg})

参数说明：
msg 异常信息字符串
返回值：


举例：
throwe("单元格值有误") 抛出一个异常，显示信息为“单元格值有误”



函数说明：
将字符串转换成时间型数据

语法：
time(stringExp)

参数说明：
stringExp HH:mm:ss格式的字符串

返回值：
时间型数据

示例：




函数说明：
生成一组连续的整数数据
语法：
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)



函数说明：
去掉字符串左右的空串
相关函数：right_trim() 去掉字符串右边的空格
left_trim() 去掉字符串左边的空格

语法：
trim(s)

参数说明：
s 待去掉左右空串的源串

返回值：
字符串型

示例：
例1：trim(" abc ") 返回:"abc"

例2：trim(" a bc ") 返回:"a bc"



函数说明：
把字符串转成大写
相关函数：lower() 把字符串转成小写
word_cap() 将字符串每一个单词的首字母大写
语法：
upper(s)

参数说明：
s 待转成大写的源串

返回值：
字符串型

示例：
例1：upper("ABCdef") 返回:"ABCDEF"

例2：upper("abcDEF") 返回:"ABCDEF"



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

语法：
value()

返回值：
当前单元格的值



函数说明：
根据指定位置返回数组或者集合表达式中的某一个元素

语法：
valueat(arrayexp，suffixExp)

参数说明：
arrayexp 数组或者集合表达式
suffixExp 整数，用于指定返回集合中的第几个元素，以0开始计数

返回值：
集合中的一个元素，数据类型由集合中的元素类型决定

示例：
例1：valueat(to(5,8),2) 返回值为：7

例2：valueat({"a","b","c"},0) 返回值为："a"



函数说明：
获得指定日期所在星期的星期天，这里认定星期天为一周的开始

语法：
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)

参数说明：
dateExp 日期或标准日期格式的字符串，
如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss

返回值：
日期时间型

示例：
例1：weekend(datetime2("19800227","yyyyMMdd")) 返回：1980-03-01 00:00:00

例2：weekend("1972-11-08 10:20:30") 返回：1972-11-11 10:20:30

例3：weekend(dateTime("2006-01-15 13:20:45")) 返回：2006-01-21 13:20:45



函数说明：
将字符串每一个单词的首字母大写
相关函数：upper() 把字符串转成大写
lower() 把字符串转成小写

语法：
wordCap(s)

参数说明：
s 需要将单词首字母大写的源串

返回值：
字符串型

示例：
例1：wordCap("I love my country") 返回："I Love My Country"

例2：wordCap("she is beautiful") 返回："She Is Beautiful"



函数说明：
从日期型数据中获得年信息

语法：
year(dateExp)

参数说明：
dateExp 日期或标准日期格式的字符串，
如：yyyy-MM-dd HH:mm:ss、yyyy-MM-dd 或 HH:mm:ss

返回值：
整数

示例：
例1：year(datetime2("19800227","yyyyMMdd")) 返回：1980

例2：year("1972-11-08 10:20:30") 返回：1972

例3：year(dateTime("2006-01-15 13:20:45")) 返回：2006