JSA
- 说明:
- JSA通用函数工具库 增强JSA能力全局可用
函数:
z转置(arr) → {Array}
- 说明:
- 将数组转置(行列互换) 系统自带的转置遇到大数组会出错
- 别名:
-
- transpose
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
arr |
Array | 要转置的数组 |
返回值:
- 转置后的数组
- Type
- Array
transpose(arr) → {Array}
- 说明:
- 将数组转置(行列互换)系统自带的转置遇到大数组会出错
- 别名:
-
- z转置
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
arr |
Array | 要转置的数组 |
返回值:
- 转置后的数组
- Type
- Array
z转数值(text) → {String}
- 说明:
- 将文本转换为数值
- 别名:
-
- val
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
text |
String | 要转换的文本 |
返回值:
- 转换后的数值
- Type
- String
val(text) → {String}
- 说明:
- 将文本转换为数值
- 别名:
-
- z转数值
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
text |
String | 要转换的文本 |
返回值:
- 转换后的数值
- Type
- String
z写入单元格(arr, rng, clearDown)
- 说明:
- 将数组输出到单元格区域 可作为数组扩展方法调用 arr.toRange("M1",true)
- 别名:
-
- toRange
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
arr |
Array | 数组 |
rng |
rng | 单元格区域 可以是地址或者单元格对象 |
clearDown |
Boolean | 是否清空目标区下方数据 |
toRange(arr, rng, clearDown)
- 说明:
- 将数组输出到单元格区域 可作为数组扩展方法调用 arr.toRange("M1",true)
- 别名:
-
- z写入单元格
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
arr |
Array | 数组 |
rng |
rng | 单元格区域 可以是地址或者单元格对象 |
clearDown |
Boolean | 是否清空目标区下方数据 |
z今天() → {String}
- 说明:
- 获取当前日期的字符串表示
- 别名:
-
- today
返回值:
- 当前日期的字符串表示
- Type
- String
today() → {String}
- 说明:
- 获取当前日期的字符串表示
- 别名:
-
- z今天
返回值:
- 当前日期的字符串表示
- Type
- String
z转日期数值(d) → {Number}
- 说明:
- 将日期对象转换为日期数值
- 别名:
-
- cdate
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
d |
Object | 要转换的日期对象 |
返回值:
- 转换后的日期数值
- Type
- Number
cdate(d) → {Number}
- 说明:
- 将日期对象转换为日期数值
- 别名:
-
- z转日期数值
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
d |
Object | 要转换的日期对象 |
返回值:
- 转换后的日期数值
- Type
- Number
z转义正则(str) → {String}
- 说明:
- 转义正则表达式中的特殊字符
- 别名:
-
- escapeRegExp
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
str |
String | 要转义的字符串 |
返回值:
- 转义后的字符串
- Type
- String
escapeRegExp(str) → {String}
- 说明:
- 转义正则表达式中的特殊字符
- 别名:
-
- z转义正则
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
str |
String | 要转义的字符串 |
返回值:
- 转义后的字符串
- Type
- String
z替换(str, find, replaceWith) → {String}
- 说明:
- 替换字符串中的指定内容
- 别名:
-
- replace
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
str |
String | 要替换的字符串 |
find |
String | 要查找的内容 |
replaceWith |
String | 替换后的内容 |
返回值:
- 替换后的字符串
- Type
- String
replace(str, find, replaceWith) → {String}
- 说明:
- 替换字符串中的指定内容 系统string自带的repalce只替换第一个
- 别名:
-
- z替换
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
str |
String | 要替换的字符串 |
find |
String | 要查找的内容 |
replaceWith |
String | 替换后的内容 |
返回值:
- 替换后的字符串
- Type
- String
z截取字符(str, start, len) → {String}
- 说明:
- 截取字符串的指定部分
- 别名:
-
- z截取字符
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
str |
String | 要截取的字符串 |
start |
Number | 起始位置 |
len |
Number | 截取的长度 |
返回值:
- 截取后的字符串
- Type
- String
mid(str, start, len) → {String}
- 说明:
- 截取字符串的指定部分
- 别名:
-
- mid
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
str |
String | 要截取的字符串 |
start |
Number | 起始位置 |
len |
Number | 截取的长度 |
返回值:
- 截取后的字符串
- Type
- String
z左取字符(str, len) → {String}
- 说明:
- 获取字符串的左侧指定长度的部分
- 别名:
-
- z左取字符
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
str |
String | 要获取部分的字符串 |
len |
Number | 要获取的长度 |
返回值:
- 左侧指定长度的部分字符串
- Type
- String
left(str, len) → {String}
- 说明:
- 获取字符串的左侧指定长度的部分
- 别名:
-
- left
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
str |
String | 要获取部分的字符串 |
len |
Number | 要获取的长度 |
返回值:
- 左侧指定长度的部分字符串
- Type
- String
z右取字符(str, len) → {String}
- 说明:
- 获取字符串的右侧指定长度的部分
- 别名:
-
- z右取字符
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
str |
String | 要获取部分的字符串 |
len |
Number | 要获取的长度 |
返回值:
- 右侧指定长度的部分字符串
- Type
- String
right(str, len) → {String}
- 说明:
- 获取字符串的右侧指定长度的部分
- 别名:
-
- right
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
str |
String | 要获取部分的字符串 |
len |
Number | 要获取的长度 |
返回值:
- 右侧指定长度的部分字符串
- Type
- String
z格式化(number, fmtstr) → {String}
- 说明:
- 格式化数字为指定格式的字符串
- 别名:
-
- z格式化
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
number |
Number | 要格式化的数字 |
fmtstr |
String | 格式化的格式字符串 |
返回值:
- 格式化后的字符串
- Type
- String
text(number, fmtstr) → {String}
- 说明:
- 格式化数字为指定格式的字符串
- 别名:
-
- text
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
number |
Number | 要格式化的数字 |
fmtstr |
String | 格式化的格式字符串 |
返回值:
- 格式化后的字符串
- Type
- String
z查找索引(关键字, 数组, 模式, 错误值) → {Object}
- 说明:
- 在数组中查找指定关键字并返回匹配的结果索引
- 别名:
-
- z查找索引
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
关键字 |
String | 要查找的关键字 |
数组 |
Array | 要查找的数组 |
模式 |
Number | 匹配模式,默认为0 |
错误值 |
String | 遇到错误时返回的值,默认为"#err" |
返回值:
- 匹配结果的索引
- Type
- Object
match(关键字, 数组, 模式, 错误值) → {Object}
- 说明:
- 在数组中查找指定关键字并返回匹配的结果索引
- 别名:
-
- match
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
关键字 |
String | 要查找的关键字 |
数组 |
Array | 要查找的数组 |
模式 |
Number | 匹配模式,默认为0 |
错误值 |
String | 遇到错误时返回的值,默认为"#err" |
返回值:
- 匹配结果的索引
- Type
- Object
z左侧查找(关键字, 数组, 结果列, 模式, 错误值) → {Object}
- 说明:
- 在数组中左侧查找指定关键字并返回结果列的值
- 别名:
-
- z左侧查找
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
关键字 |
String | 要查找的关键字 |
数组 |
Array | 要查找的数组 |
结果列 |
Number | 结果列的索引 |
模式 |
Number | 匹配模式,默认为0 |
错误值 |
String | 遇到错误时返回的值,默认为"#err" |
返回值:
- 匹配结果的值
- Type
- Object
vlookup(关键字, 数组, 结果列, 模式, 错误值) → {Object}
- 说明:
- 在数组中左侧查找指定关键字并返回结果列的值
- 别名:
-
- vlookup
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
关键字 |
String | 要查找的关键字 |
数组 |
Array | 要查找的数组 |
结果列 |
Number | 结果列的索引 |
模式 |
Number | 匹配模式,默认为0 |
错误值 |
String | 遇到错误时返回的值,默认为"#err" |
返回值:
- 匹配结果的值
- Type
- Object
z转文本(v) → {String}
- 说明:
- 将值转换为文本格式
- 别名:
-
- z转文本
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
v |
Any | 要转换的值 |
返回值:
- 转换后的文本格式
- Type
- String
cstr(v) → {String}
- 说明:
- 将值转换为文本格式
- 别名:
-
- cstr
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
v |
Any | 要转换的值 |
返回值:
- 转换后的文本格式
- Type
- String
z取整数(v) → {Number}
- 说明:
- 获取一个数的整数部分
- 别名:
-
- z取整数
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
v |
Number | 要获取整数部分的数 |
返回值:
- 整数部分
- Type
- Number
cint(v) → {Number}
- 说明:
- 获取一个数的整数部分
- 别名:
-
- cint
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
v |
Number | 要获取整数部分的数 |
返回值:
- 整数部分
- Type
- Number
z取小数(v) → {Number}
- 说明:
- 获取一个数的小数部分
- 别名:
-
- z取小数
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
v |
Number | 要获取小数部分的数 |
返回值:
- 小数部分
- Type
- Number
getDecimal(v) → {Number}
- 说明:
- 获取一个数的小数部分
- 别名:
-
- getDecimal
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
v |
Number | 要获取小数部分的数 |
返回值:
- 小数部分
- Type
- Number
z转公式数组(arr) → {String}
- 说明:
- 将数组转换为Excel公式字符串
- 别名:
-
- z转公式数组
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
arr |
Array | 要转换的数组 |
返回值:
- 转换后的Excel公式字符串
- Type
- String
ToExcelArray(arr) → {String}
- 说明:
- 将数组转换为Excel公式字符串
- 别名:
-
- ToExcelArray
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
arr |
Array | 要转换的数组 |
返回值:
- 转换后的Excel公式字符串
- Type
- String
z增强查找(关键字, 查找数组, 结果数组, 错误值) → {Object}
- 说明:
- 增强的查找函数,返回匹配结果的索引
- 别名:
-
- z增强查找
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
关键字 |
String | 要查找的关键字 |
查找数组 |
Array | 要查找的数组 |
结果数组 |
Array | 结果数组 |
错误值 |
String | 遇到错误时返回的值,默认为空字符串 |
返回值:
- 匹配结果的索引
- Type
- Object
xlookup(关键字, 查找数组, 结果数组, 错误值) → {Object}
- 说明:
- 增强的查找函数,返回匹配结果的索引
- 别名:
-
- xlookup
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
关键字 |
String | 要查找的关键字 |
查找数组 |
Array | 要查找的数组 |
结果数组 |
Array | 结果数组 |
错误值 |
String | 遇到错误时返回的值,默认为空字符串 |
返回值:
- 匹配结果的索引
- Type
- Object
z求和() → {Number}
- 说明:
- 对一组数值进行求和
- 别名:
-
- z求和
返回值:
- 求和结果
- Type
- Number
sum() → {Number}
- 说明:
- 对一组数值进行求和
- 别名:
-
- sum
返回值:
- 求和结果
- Type
- Number
z最大值() → {Number}
- 说明:
- 获取一组数值中的最大值
- 别名:
-
- z最大值
返回值:
- 最大值
- Type
- Number
max() → {Number}
- 说明:
- 获取一组数值中的最大值
- 别名:
-
- max
返回值:
- 最大值
- Type
- Number
z最小值() → {Number}
- 说明:
- 获取一组数值中的最小值
- 别名:
-
- z最小值
返回值:
- 最小值
- Type
- Number
min() → {Number}
- 说明:
- 获取一组数值中的最小值
- 别名:
-
- min
返回值:
- 最小值
- Type
- Number
z平均值() → {Number}
- 说明:
- 计算一组数值的平均值
- 别名:
-
- z平均值
返回值:
- 平均值
- Type
- Number
average() → {Number}
- 说明:
- 计算一组数值的平均值
- 别名:
-
- average
返回值:
- 平均值
- Type
- Number
z模糊匹配(str, pattern) → {String}
- 说明:
- 模糊匹配字符串与模式
- 别名:
-
- z模糊匹配
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
str |
String | 要匹配的字符串 |
pattern |
String | 匹配模式 |
返回值:
- 匹配结果
- Type
- String
like(str, pattern) → {String}
- 说明:
- 模糊匹配字符串与模式
- 别名:
-
- like
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
str |
String | 要匹配的字符串 |
pattern |
String | 匹配模式 |
返回值:
- 匹配结果
- Type
- String
z生成数字序列(开始, 结束, 步长) → {Array}
- 说明:
- 生成一个数字序列数组
- 别名:
-
- z生成数字序列
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
开始 |
Number | 序列的起始值 |
结束 |
Number | 序列的结束值,默认为空字符串 |
步长 |
Number | 序列的步长,默认为1 |
返回值:
- 生成的数字序列数组
- Type
- Array
getNumberArray(开始, 结束, 步长) → {Array}
- 说明:
- 生成一个数字序列数组
- 别名:
-
- getNumberArray
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
开始 |
Number | 序列的起始值 |
结束 |
Number | 序列的结束值,默认为空字符串 |
步长 |
Number | 序列的步长,默认为1 |
返回值:
- 生成的数字序列数组
- Type
- Array
z人民币大写(n) → {String}
- 说明:
- 将数字转换为人民币大写
- 别名:
-
- z人民币大写
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
n |
Number | 要转换的数字 |
返回值:
- 转换后的人民币大写
- Type
- String
rmbdx(n) → {String}
- 说明:
- 将数字转换为人民币大写
- 别名:
-
- rmbdx
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
n |
Number | 要转换的数字 |
返回值:
- 转换后的人民币大写
- Type
- String
z随机整数(开始, 结束) → {Number}
- 说明:
- 生成一个指定范围内的随机整数
- 别名:
-
- z随机整数
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
开始 |
Number | 随机整数的起始值 |
结束 |
Number | 随机整数的结束值 |
返回值:
- 生成的随机整数
- Type
- Number
rndInt(开始, 结束) → {Number}
- 说明:
- 生成一个指定范围内的随机整数
- 别名:
-
- rndInt
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
开始 |
Number | 随机整数的起始值 |
结束 |
Number | 随机整数的结束值 |
返回值:
- 生成的随机整数
- Type
- Number
z随机整数数组(开始, 结束, 个数) → {Array}
- 说明:
- 生成一个指定范围内的随机整数数组
- 别名:
-
- z随机整数数组
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
开始 |
Number | 随机整数的起始值 |
结束 |
Number | 随机整数的结束值 |
个数 |
Number | 随机整数的个数 |
返回值:
- 生成的随机整数数组
- Type
- Array
rndIntArray(开始, 结束, 个数) → {Array}
- 说明:
- 生成一个指定范围内的随机整数数组
- 别名:
-
- rndIntArray
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
开始 |
Number | 随机整数的起始值 |
结束 |
Number | 随机整数的结束值 |
个数 |
Number | 随机整数的个数 |
返回值:
- 生成的随机整数数组
- Type
- Array
z随机小数(m, n, 位数) → {Array}
- 说明:
- 生成一个指定范围内的随机小数
- 别名:
-
- z随机小数
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
m |
Number | 随机小数的最小值 |
n |
Number | 随机小数的最大值 |
位数 |
Number | 小数的位数,默认为10 |
返回值:
- 生成的随机小数
- Type
- Array
rndFloat(m, n, 位数) → {Array}
- 说明:
- 生成一个指定范围内的随机小数
- 别名:
-
- rndFloat
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
m |
Number | 随机小数的最小值 |
n |
Number | 随机小数的最大值 |
位数 |
Number | 小数的位数,默认为10 |
返回值:
- 生成的随机小数
- Type
- Array
z随机小数数组(m, n, 个数, 位数) → {Array}
- 说明:
- 生成一个指定范围内的随机小数数组
- 别名:
-
- z随机小数数组
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
m |
Number | 随机小数的最小值 |
n |
Number | 随机小数的最大值 |
个数 |
Number | 随机小数的个数 |
位数 |
Number | 小数的位数,默认为10 |
返回值:
- 生成的随机小数数组
- Type
- Array
rndFloatArray(m, n, 个数, 位数) → {Array}
- 说明:
- 生成一个指定范围内的随机小数数组
- 别名:
-
- rndFloatArray
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
m |
Number | 随机小数的最小值 |
n |
Number | 随机小数的最大值 |
个数 |
Number | 随机小数的个数 |
位数 |
Number | 小数的位数,默认为10 |
返回值:
- 生成的随机小数数组
- Type
- Array
z随机打乱(array) → {Array}
- 说明:
- 随机打乱数组的顺序
- 别名:
-
- z随机打乱
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
array |
Array | 要打乱顺序的数组 |
返回值:
- 打乱顺序后的数组
- Type
- Array
shuffle(array) → {Array}
- 说明:
- 随机打乱数组的顺序
- 别名:
-
- shuffle
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
array |
Array | 要打乱顺序的数组 |
返回值:
- 打乱顺序后的数组
- Type
- Array
z随机乱序数字序列(开始, 结束, 步长) → {Array}
- 说明:
- 生成一个指定范围内的随机乱序数字序列数组
- 别名:
-
- z随机乱序数字序列
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
开始 |
Number | 数字序列的起始值 |
结束 |
Number | 数字序列的结束值,默认为空字符串 |
步长 |
Number | 数字序列的步长,默认为1 |
返回值:
- 生成的随机乱序数字序列数组
- Type
- Array
shuffleNumbers(开始, 结束, 步长) → {Array}
- 说明:
- 生成一个指定范围内的随机乱序数字序列数组
- 别名:
-
- shuffleNumbers
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
开始 |
Number | 数字序列的起始值 |
结束 |
Number | 数字序列的结束值,默认为空字符串 |
步长 |
Number | 数字序列的步长,默认为1 |
返回值:
- 生成的随机乱序数字序列数组
- Type
- Array
z延时(ts, fn) → {undefined}
- 说明:
- 延时执行函数
- 别名:
-
- z延时
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
ts |
Number | 延时时间(毫秒) |
fn |
function | 要执行的函数,默认为null |
返回值:
- Type
- undefined
delay(ts) → {undefined}
- 说明:
- 延时执行函数
- 别名:
-
- delay
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
ts |
Number | 延时时间(毫秒) |
返回值:
- Type
- undefined
z统一路径分隔符(path) → {String}
- 说明:
- 统一路径分隔符为指定格式
- 别名:
-
- z统一路径分隔符
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
path |
String | 要处理的路径 |
返回值:
- 处理后的路径
- Type
- String
normalPath(path) → {String}
- 说明:
- 统一路径分隔符为指定格式
- 别名:
-
- normalPath
参数列表:
参数名称 | 参数类型 | 备注 |
---|---|---|
path |
String | 要处理的路径 |
返回值:
- 处理后的路径
- Type
- String
z格式化(template, …args) → {String}
- 说明:
- 格式化字符串模板
- 别名:
-
- z格式化
参数列表:
参数名称 | 参数类型 | 属性 | 备注 |
---|---|---|---|
template |
String | 字符串模板 | |
args |
any |
<repeatable> |
替换模板中占位符的值 |
返回值:
- 格式化后的字符串
- Type
- String
format(template, …args) → {String}
- 说明:
- 格式化字符串模板
- 别名:
-
- format
参数列表:
参数名称 | 参数类型 | 属性 | 备注 |
---|---|---|---|
template |
String | 字符串模板 | |
args |
any |
<repeatable> |
替换模板中占位符的值 |
返回值:
- 格式化后的字符串
- Type
- String