JSA

命名空间

JSA

说明:
  • JSA通用函数工具库 增强JSA能力全局可用
作者:
  • 郑广学 2023.9.10 微信公众号EXCEL880 官网vbayyds.com

函数:

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