填报表 JavaScript 函数
为方便用户在填报表数值格中添加表达式进行计算，产品提供了如下函数方便用户使用。除下列函数外，数值格中还支持使用JS函数。
sum()
函数说明：
对扩展格的扩展数据或一片连续非扩展数据区域数据进行汇总，仅支持1个参数或者2个参数。
语法：
sum(cell)
sum(cell1:cell2)
sum(cell1,cell2)
参数说明：
|
cell |
可扩展单元格 |
|
cell1 |
起始格 |
|
cell2 |
结束格 |
返回值：
数值
示例：
例1：sum({B1}) 对填报表可扩展格B1求和
行式报表扩展格的汇总表达式可以简化为sum(B1)。但是如果行式填报表数据需要导出到EXCEL，那么就要将sum(B1)格式写成sum({B1})，这样导出EXCEL时才能正确扩展。
例2：sum(A1:B10) 对连续非扩展区域A1至B10之间单元格求和
例3：sum(A1,B10) 对连续非扩展区域A1至B10之间单元格求和
average()
函数说明：
对扩展格扩展数据或一片连续非扩展数据区域的数据求平均值，仅支持1个参数或者2个参数。
语法：
average(cell)
average(cell1:cell2)
average(cell1,cell2)
参数说明：
|
cell |
可扩展单元格 |
|
cell1 |
起始格 |
|
cell2 |
结束格 |
返回值：
数值
示例：
例1：average({B1}) 对填报表可扩展格B1求平均值
行式报表扩展格的求平均值表达式可以简化成average(B1)。但是如果行式填报表数据需要导出到EXCEL，那么就要将average(B1)格式写成average({B1})，这样导出EXCEL时才能正确扩展。
例2：average (A1:B10) 对连续非扩展区域A1至B10之间单元格求平均值
例3：average(A1,B10) 对连续非扩展区域A1至B10之间单元格求平均值
count()
函数说明：
对扩展格或一片连续非扩展数据区域的格值序列的非空成员计数，仅支持1个参数或者2个参数。
语法：
count(cell)
count(cell1:cell2)
count(cell1,cell2)
参数说明：
|
cell |
可扩展单元格 |
|
cell1 |
起始格 |
|
cell2 |
结束格 |
返回值：
数值
示例：
例1：count({B1}) 对填报表可扩展格B1的个数求和
行式报表扩展格的个数求和表达式可以简化为count(B1)。但是如果行式填报表数据需要导出到EXCEL，那么就要将count(B1)格式写成count({B1})，这样导出EXCEL时才能正确扩展。
例2：count(A1:B10) 对连续非扩展区域A1至B10之间的个数求和
例3：count(A1,B10) 对连续非扩展区域A1至B10之间的个数求和
max()
函数说明：
对扩展格扩展数据或一片连续非扩展数据区域中的数据求最大值，仅支持1个参数或者2个参数。
语法：
max(cell)
max(cell1:cell2)
max(cell1,cell2)
参数说明：
|
cell |
可扩展单元格 |
|
cell1 |
起始格 |
|
cell2 |
结束格 |
返回值：
数值
示例：
例1：max({B1}) 对填报表可扩展格B1的数据求最大值
行式报表扩展格的求最大值表达式可以简化为max(B1)。但是如果行式填报表数据需要导出到EXCEL，那么就要将max(B1)格式写成max({B1})，这样导出EXCEL时才能正确扩展。
例2：max(A1:B10) 获取连续非扩展区域A1至B10之间的最大值
例3：max(A1,B10) 获取连续非扩展区域A1至B10之间的最大值
min()
函数说明：
对扩展格扩展数据或一片连续非扩展数据区域的数据求最小值，仅支持1个参数或者2个参数。
语法：
min(cell)
min(cell1:cell2)
min(cell1,cell2)
参数说明：
|
cell |
可扩展单元格 |
|
cell1 |
起始格 |
|
cell2 |
结束格 |
返回值：
数值
示例：
例1：min({B1}) 获取填报表可扩展格B1的扩展数据的最小值
行式报表扩展格的求最小值表达式可以简化为min(B1)。但是如果行式填报表数据需要导出到EXCEL，那么就要将min(B1)格式写成min({B1})，这样导出EXCEL时才能正确扩展。
例2：min(A1:B10) 获取连续非扩展区域A1至B10之间的最小值
例3：min(A1,B10) 获取连续非扩展区域A1至B10之间的最小值
sumproduct()
函数说明：
求两个单元格数组中同位单元格的乘积之和。两个单元格数组的成员数必须一致。
语法：
sumproduct(cell1,cell2)
sumproduct(cell3:cell4,cell5:cell6)
参数说明：
|
cell1/cell2 |
可扩展单元格 |
|
cell3/cell5 |
起始格 |
|
cell4/cell6 |
结束格 |
返回值：
数值
示例：
例1：sumproduct ({B1},{C1}) 对填报表可扩展格B1，C1的单元格数组求乘积之和
例2：sumproduct (A1:B10,C1:D10) 对连续非扩展区域A1至B10单元格数组与连续区域C1至D10单元格数组求乘积之和
switchCase()
函数说明：
根据表达式的不同计算结果，返回不同的值。本函数:从左到右计算，先出现的表达式先算，如果出现满足的表达式，则返回相应的结果，后面的不再计算。如果没有一个表达式满足条件，则返回缺省值，缺省值不可省略。
语法：
switchCase(cellExp,x1,y1,x2,y2,{…xk,yk,}y)
参数说明：
|
cellExp |
可扩展单元格/表达式 |
|
x1 |
值 |
|
y1 |
返回值 |
|
y |
缺省返回值，不可省略 |
返回值：
数据类型不定，由返回值结果决定
示例：
例1：switchCase(B1, "M","男","F","女","缺省") 若B1当前格格值为“M”，则返回“男”，若B1当前格格值为“F”，则返回“女”，否则，返回“缺省”。
sumn()
函数说明：
对扩展格的扩展数据、个别单元格数据或一片连续非扩展数据区域数据进行汇总，支持任意数量的参数，不支持行式扩展。
语法：
sumn({cell})
sumn(cell1:cell2, cell3…)
sumn(cell3,cell4)
参数说明：
|
cell |
可扩展单元格 |
|
cell1 |
起始格 |
|
cell2 |
结束格 |
|
cell3 |
单元格 |
|
cell4 |
单元格 |
返回值：
数值
示例：
例1：sumn({B1}) 对网格式填报表可扩展格B1求和
例2：sumn(A1,B3) 对A1和B3单元格求和
例3：sumn(A1:B2,B3,A4:A7) 对连续非扩展区域A1至B2之间的单元格、B3单元格和A4至A7之间的单元格求和，即对A1、B1、A2、B2、B3、A4、A5、A6和A7单元格求和。
averagen()
函数说明：
对扩展格的扩展数据、个别单元格数据或一片连续非扩展数据区域数据计算平均值，支持任意数量的参数，不支持行式扩展。
语法：
averagen({cell})
averagen(cell1:cell2, cell3…)
averagen(cell3,cell4)
参数说明：
|
cell |
可扩展单元格 |
|
cell1 |
起始格 |
|
cell2 |
结束格 |
|
cell3 |
单元格 |
|
cell4 |
单元格 |
返回值：
数值
示例：
例1：averagen({B1}) 对网格式填报表可扩展格B1求平均值
例2：averagen(A1,B3) 对A1和B3单元格求平均值
例3：averagen(A1:B2,B3,A4:A7) 对连续非扩展区域A1至B2之间的单元格、B3单元格和A4至A7之间的单元格求平均值，即对A1、B1、A2、B2、B3、A4、A5、A6和A7单元格求平均值。
countn()
函数说明：
对扩展格、个别单元格或一片连续非扩展数据区域的格值序列的非空成员计数，支持任意数量的参数，不支持行式扩展。
语法：
countn({cell})
countn(cell1:cell2, cell3…)
countn(cell3,cell4)
参数说明：
|
cell |
可扩展单元格 |
|
cell1 |
起始格 |
|
cell2 |
结束格 |
|
cell3 |
单元格 |
|
cell4 |
单元格 |
返回值：
数值
示例：
例1：countn({B1}) 对网格式填报表可扩展格B1个数求和
例2：countn(A1,B3) 对A1和B3单元格个数求和，返回2
例3：countn(A1:B2,B3,A4:A7) 对连续非扩展区域A1至B2之间的单元格、B3单元格和A4至A7之间的单元格个数求和，即对A1、B1、A2、B2、B3、A4、A5、A6和A7单元格个数求和。
maxn()
函数说明：
对扩展格的扩展数据、个别单元格数据或一片连续非扩展数据区域数据求最大值，支持任意数量的参数，不支持行式扩展。
语法：
maxn({cell})
maxn(cell1:cell2, cell3…)
maxn(cell3,cell4)
参数说明：
|
cell |
可扩展单元格 |
|
cell1 |
起始格 |
|
cell2 |
结束格 |
|
cell3 |
单元格 |
|
cell4 |
单元格 |
返回值：
数值
示例：
例1：maxn({B1}) 对网格式填报表可扩展格B1求最大值
例2：maxn(A1,B3) 对A1和B3单元格求最大值
例3：maxn(A1:B2,B3,A4:A7) 对连续非扩展区域A1至B2之间的单元格、B3单元格和A4至A7之间的单元格求最大值，即对A1、B1、A2、B2、B3、A4、A5、A6和A7单元格求最大值。
minn()
函数说明：
对扩展格的扩展数据、个别单元格数据或一片连续非扩展数据区域数据求最小值，支持任意数量的参数，不支持行式扩展。
语法：
minn({cell})
minn(cell1:cell2, cell3…)
minn(cell3,cell4)
参数说明：
|
cell |
可扩展单元格 |
|
cell1 |
起始格 |
|
cell2 |
结束格 |
|
cell3 |
单元格 |
|
cell4 |
单元格 |
返回值：
数值
示例：
例1：minn({B1}) 对网格式填报表可扩展格B1求最小值
例2：minn(A1,B3) 对A1和B3单元格求最小值
例3：minn(A1:B2,B3,A4:A7) 对连续非扩展区域A1至B2之间的单元格、B3单元格和A4至A7之间的单元格求最小值，即对A1、B1、A2、B2、B3、A4、A5、A6和A7单元格求最小值。
format()
函数说明：
将日期、日期时间、时间类型的值转换为指定格式的字符串。
用于自动计算时将日期、日期时间、时间格式转换为理想的格式串。
语法：
date.format(fmt)
datetime.format(fmt)
time.format(fmt)
参数说明：
fmt 格式串，按照需求任意组合并添加分隔符，例如：yyyy年MM月dd日、yyyy/MM/dd HH:mm:ssS等。
|
y |
年份 |
|
M |
月份 |
|
d |
日 |
|
H |
时 |
|
m |
分 |
|
s |
秒 |
|
q |
季度 |
|
S |
毫秒 |
返回值：
字符串
示例：
例1：B1.format("yyyy年MM月dd日")
B1为日期类型"2023-02-10"，返回值为字符串"2023年02月10日"
例2：B1.format("yyyy年 第q季度")
B1为日期类型"2023-02-10"，返回值为字符串"2023年 第1季度"
例3：arg1.format("yyyy/MM/dd H:m:s")
参数arg1为"2023-02-10 08:05:10"，返回值为字符串"2023/02/10 8:5:10"