方法

时间戳格式化

方法名：m_DateFormat(timeTemp [,format])

优化版本：2.0.3+

属性

属性	类型	必须	备注
timeTemp	number	是	时间戳
format	dateformat	否	格式化类型

dateformat

格式	含义	备注
YYYY	年	2.0.3之前:yyyy/YYYY
MM	月
DD	日
hh	时
mm	分
ss	秒
S	毫秒
q	季度
week	本月中的第几周	2.0.3之前: w
weekday	一周中的周几	2.0.3之前: d
yearweek	本年度第几周	2.0.3之前: WW
yearday	本年度第几天	2.0.3之前: n

数字千分位逗号

方法名：m_NumberDot(number [,boolean])

属性

属性	类型	必须	备注
number	number	是	要转的数字
boolean	boolean	否	小数位是否千分位转换

数据脱敏

方法名：m_ReplaceStar(value [,start,end])

如果 value.length < start+end，或者 value 不为字符串类型，则原值返回，控制台会错误提示

属性

属性	类型	必须	备注
value	string	是	要转的值
start	number	否	数据前显示几位，默认 3
end	number	否	数据末显示几位，默认 4

是否带有小数位

方法名：m_NumberIsFloat(number [,maxLen])

属性

属性	类型	必须	备注
number	number	是	要判断的数字
maxLen	number	否	判断小数位是否小于等于 maxLen,该参数存在或为 0 时，整数也会返回 true，该参数不存在时，默认不限制小数位，整数返回 false

示例中 maxLen = 0 等同于 maxlen 不存在

数字转万单位且千分位

方法名：m_NumberWan(number [,float])

属性

属性	类型	必须	备注
number	number	是	要判断的数字
float	number	否	转万后要保留的小数位数

复制

方法名：m_Copy(text)，返回true/false

属性

属性	类型	必须	备注
text	any	是	要复制的值

深拷贝

方法名：m_DeepClone(value)

属性

属性	类型	必须	备注
value	any	是	要深拷贝的内容

离屏文件选择(input file)

方法名：m_OutScreenFileChoose(config)，所选择的文件不能直接 img 展示

config

属性	类型	必须	备注
fileName	string	否	上传时字段名，默认 file
accept	string	否	文件选择类型，默认：image/*
multiple	boolean	否	是否多选，默认：false，安卓好像多选不得行
formData	boolean	否	是否要转为 formData 格式，默认：false，返回 fileList

返回 Promise，结果为 file/formData 文件或空

file 转 base64

方法名：m_FileToBase64(file)，结合离屏文件选择演示

属性

属性	类型	必须	备注
file	file	是	要转的 file 文件

返回 Promise，结果为 file 或空

base64 转 file

方法名：m_Base64toBlob(base64),结合离屏文件选择及file 转 base64演示

属性

属性	类型	必须	备注
base64	base64	是	要转的 base64 代码

返回 Promise，结果为 base64 或空

删除对象中的空属性

方法名：m_DeleteEmptyObj(obj)

空属性包含（null,undefined,''）

属性

属性	类型	必须	备注
obj	object	是	要删除空的对象

资源文件下载

方法名：m_FileDownload(link [,name])

属性

属性	类型	必须	备注
link	string	是	要下载的链接地址
name	string	否	下载后保存的文件名称

可以下载图片、文档类型，微信 H5 不适用，建议提示去非微信浏览器打开下载，注意跨域问题。

返回 Promise，结果为 true/false

缓存类：sessions

方法名：m_sessions.set(name,value)、 m_sessions.get(name)、 m_sessions.remove(name)、 m_sessions.clear()

缓存采用的是JSON.stringify和JSON.parse进行的转换，使用请注意 JSON 转换的利弊。

属性

属性	类型	必须	备注
name	string	是	缓存名称
value	any	否	缓存值

示例结果请在控制台查看。

缓存类：local

方法名：m_local.set(name,value)、 m_local.get(name)、 m_local.remove(name)、 m_local.clear()

缓存采用的是JSON.stringify和JSON.parse进行的转换，使用请注意 JSON 转换的利弊。

属性

属性	类型	必须	备注
name	string	是	缓存名称
value	any	否	缓存值

示例结果请在控制台查看。

防抖

方法名：m_Debounce(callback,time)

属性

属性	类型	必须	备注
callback	Function	是	回调函数
time	number	否	防抖时长，单位毫秒，默认 300

节流

方法名：m_Throttle(callback,time)

属性

属性	类型	必须	备注
callback	Function	是	回调函数
time	number	否	节流时长，单位毫秒，默认 300

延时器

方法名：m_TimeOut(callback,time)

版本：2.0.3+

自己写延时器，需要写 setTimeout 然后 clearTimeout 等等，重复太多，故封装，调用即可无需自己在去清除延时器

属性

属性	类型	必须	备注
callback	Function	是	回调函数
time	number	否	延时器时长，单位毫秒，默认 1000

树结构转一维数组

方法名：m_TreeToArray(nodes,childKey)

版本：2.0.3+

返回数组

属性

属性	类型	必须	备注
nodes	array	是	要转的树数据，是一个数组形式的树，即最外层应该是[]包起来的
childKey	string	否	子集字段，可选，默认 children

改变指定对象的键

方法名：m_ChangeObjKey(nodes,options)

版本：2.0.3+

将会改变 nodes 下所有相关的键，无论层级

返回改后的 nodes

属性

属性	类型	必须	备注
nodes	object	是	要转的树数据
options	object	否	配置参数，如

删除数据中的空格

方法名：m_DeleteSpaces(value,bool)

版本：2.0.3+

返回处理后的数据

属性

属性	类型	必须	备注
value	any	是	要删除空格的数据
bool	boolean	否	undefined 和 null 是否需要转为空字符串，默认 false

校验数据指定字段不能为空

方法名：m_RequiredKey(obj,keys)

版本：2.0.3+

返回校验失败的 keys 数组，且控制台 error 打印，数组为空则通过

属性

属性	类型	必须	备注
obj	object	是	被校验 json 型数据，数组自行循环处理
keys	string[]	否	被校验的字段，字符串数组，支持a.b格式

根据已知值及值所在数组/树形结构数据，获取指定字段值

方法名：m_GetValueByKeyForObject(options)

版本：2.0.3+

有点绕，简单来说就是我拿到了数据中字段 id 的值，我想获取对应的 name 值

返回数组

options

属性	类型	必须	备注
value	string/string[]	是	值，数组，一个值的情况可以不用数组
source	array/object	是	源数据，単树或数组树
valueKey	string	是	value 对应的 key
targetKey	string	是	需要获取的值对应的 key
treeDataAll	boolean	是	source 为树时，是否返回每一级值，默认 false
treeChildKey	string	是	source 为树时，它的子集字段 key，默认为 children

文案高亮

方法名：m_HighLight(options)

版本：2.0.3+

返回处理后的结果列表

options

属性	类型	必须	备注
keyword	string	是	高亮的关键字
list	any[]	是	列表数据
key	string	是	高亮的值对应的 key，默认''
el	htmlTag	否	指定 html 标签包裹高亮的值，默认 span
color	string	否	高亮颜色，默认#ff0000

空值判断

方法名：m_IsEmpty(value)

版本：2.0.3+

主要校验：undefined, null, ''

属性

属性	类型	必须	备注
value	any	是	要判断的值

数字长度不足前置位补 0

方法名：m_NumberFixZero(number,len)

版本：2.0.3+

属性

属性	类型	必须	备注
number	string/number	是	数值，数字或数字字符串
len	number	是	指定长度

数字输入限制

方法名：m_NumberFilter(value,floatLen,negative)

版本：2.0.3+

主要用于 input 输入时格式化

返回格式化后的值

属性

属性	类型	必须	备注
value	number/string	是	数字或数字字符串
floatLen	number	否	小数位数，默认 2
negative	boolean	否	是否可以为负数，默认 false

json 多层级拍平

方法名：m_FlattenJSON(obj,res,extraKey)

版本：2.0.3+

属性

属性	类型	必须	备注
source	object	是	要拍平的 json 数据
res	object	否	已存在的一维 json 数据，默认{}
extraKey	string	否	key 前置串，默认''

判断两个 object/array 是否相等

方法名：m_CheckEqualObject(obj1,obj2)

版本：2.0.3+

适用于基础类型的 json 比较

属性

属性	类型	必须	备注
obj1	object	是	要比对的数据
obj2	object	是	要比对的数据