示例:
例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