JS SDK

事件触发器 history.router.emitter

用于页面间派发和接收事件。history.router.emitter 是一个轻量级的 JavaScript 事件触发器，它提供了基本的事件触发、事件监听和取消事件监听功能，详细使用可参考 mitt

使用平台全局触发器，使用前先添加引用

import history from "core/appHistory";

如果想单独使用，不与平台全局事件触发器混合使用，请使用原生插件（原生插件使用请参考插件官网），使用前先添加引用

import mitt from 'mitt';

触发事件

• 方法：history.router.emitter.emit(eventName, params)
• 参数
  • eventName：事件名称
  • params：事件参数（多个参数请使用 json 对象）
• 说明：如果触发事件存在，则在类型匹配的处理程序之后调用 '*' 处理程序。
• 示例：

history.router.emitter.emit("alertStr",{a:"1",b:"2",c:"3"});

监听事件

• 方法：history.router.emitter.on(eventName, handler)
• 参数
  • eventName：事件名称（字符串 | 符号），所有事件使用 '*'
  • handler：函数，为响应给定事件而调用的函数
• 示例：

history.router.emitter.on("alertStr",({a,b,c})=>{  
    alert(`${a}++++++++++++++${b}++++++++++++++${c}`);
})

移除监听

• 方法：history.router.emitter.off(eventName, handler)
• 参数
  • eventName：事件名称
  • handler：函数。如果省略 handler ，则将删除给定类型的所有处理程序。
• 示例：

const testFn=({a,b,c})=>{  
    alert(`${a}++++++++++++++${b}++++++++++++++${c}`);
}
history.router.emitter.off("alertStr",testFn);
history.router.emitter.on("alertStr",testFn);

获取所有监听事件

• 属性：history.router.emitter.all
• 示例：

const allEmit=history.router.emitter.all;
console.log(allEmit);//输出json数组对象

设备工具类 detector

用于获取当前设备信息，浏览器信息等，例如查看是移动设备还是 PC 设备，具体介绍参考 detector ，使用前先添加引用

import detector from 'detector';

示例： 获取设备名称：detector.device.name //pc 获取浏览器名称：detector.browser.name //chrome 获取浏览器版本：detector.browser.version //109

更多用法，参考插件官网：https://hotoo.github.io/detector/

UUID 工具类

用于生成一个 UUID，使用前先添加引用

import UUID from "$UI/wxsys/lib/base/uuid";

生成32位 UUID

• createUUID()
• new UUID().toString()

示例：

const uuid1=new UUID().toString();//CADDD21E82B00001D494A2001C329F50
const uuid4=UUID.createUUID();//CADDD21E82C0000138B313229690176D

生成19位 UUID

• createShortUUID()
• new UUID(true).toString()

示例：

const uuid2=new UUID(true).toString();//p085UKE33hPsL7U45kk
const uuid3=UUID.createShortUUID();//p085UKE33CnnhUPE8dq

MD5 工具类

用于对一个字符串进行 md5 加密，使用前先添加引用

import MD5 from "$UI/wxsys/lib/base/md5";

使用加密方法前，需要使用 new MD5(hexcase) 进行构造，其中 hexcase 参数针对“Hex 加密”，设置为 true 返回大写字母，设置为 false 返回小写字母，默认返回小写字母

Hex 加密

• 方法：hex_md5(input)
• 参数
  • input：字符串
• 示例

const exampleStr="justep";
const md5Str=new MD5().hex_md5(exampleStr);//d77f63daa21849e228a9e796833b84c3
const md5Str=new MD5(true).hex_md5(exampleStr);//D77F63DAA21849E228A9E796833B84C3

Base64 加密

• 方法：b64_md5(input)
• 参数
  • input：字符串
• 示例

const exampleStr="justep";
const b64Str=new MD5().b64_md5(exampleStr);//139j2qIYSeIoqeeWgzuEww

Base64 工具类

用于实现 Base64 编码和解码，使用前先添加引用

import Base64 from "$UI/wxsys/lib/base/base64";

Base64 编码

• 方法：encode(input)
• 参数
  • input：编码字符串
• 示例：

const exampleStr="justep";
const base64=Base64.encode(exampleStr);//anVzdGVw

Base64 解码

• 方法：decode(input)
• 参数
  • input：解码字符串
• 示例：

const exampleStr="justep";
const base64=Base64.encode(exampleStr);//anVzdGVw
const decodeStr=Base64.decode(base64);//justep

密码加密

在请求中如果要传输密码，应该对密码先进行加密，系统提供前端加密，后端解密的方法，参考《密码工具类 PasswordUtil》。

前端加密先引用 uaa，代码如下

import uaa from "$UI/wxsys/comps/user/js/uaa";

加密方法

• 方法：encodePassword(password)
• 参数：
  • password：要加密的密码
• 返回值：加密后的密码
• 示例

uaa.encodePassword("aSDF1@#$")

请求加密工具类 crypto-request

在系统中开启安全插件后，系统自动加密请求中的请求参数，一般情况下，无需手工加密。如遇特殊情况，系统提供加密和解密方法，在使用前添加引用

import CryptoRequest from "core/api/network/crypto-request";

URL 加密

• 方法：encode(url)
• 参数
  • url：需要加密的 url
• 示例：

const url3="https://entrylzsdev6-vipabe265ab.trunk.xcaas.net/wftest/main/dbrest/wftest?title=标题名称";
let cryptoHref2 = CryptoRequest.encode(url3);//https://entrylzsdev6-vipabe265ab.trunk.xcaas.net/wftest/main/dbrest/wftest?crypto_query=d0016843a071a657a4296824453d2566683c50b3b2cc7833ed1144b4b7d2c49274a7b8c45aef1b751fb7cdacdc52d81dbb7263b40b1cb0003d0559c6f3bdeeea

URL 解密

• 方法：decode(url)
• 参数
  • url：需要解密的 url
• 示例：

const url3="https://entrylzsdev6-vipabe265ab.trunk.xcaas.net/wftest/main/dbrest/wftest?title=标题名称";
let cryptoHref2 = CryptoRequest.encode(url3);//https://entrylzsdev6-vipabe265ab.trunk.xcaas.net/wftest/main/dbrest/wftest?crypto_query=d0016843a071a657a4296824453d2566683c50b3b2cc7833ed1144b4b7d2c49274a7b8c45aef1b751fb7cdacdc52d81dbb7263b40b1cb0003d0559c6f3bdeeea
let cryptoHref3 = CryptoRequest.decode(cryptoHref2);//https://entrylzsdev6-vipabe265ab.trunk.xcaas.net/wftest/main/dbrest/wftest?title=%E6%A0%87%E9%A2%98%E5%90%8D%E7%A7%B0

字符串函数

去除前后空格

• 方法：wx.String.trim(str)
• 描述：清除字符串前后两端的空白字符
• 参数
  • str:字符串
• 示例：

const str=wx.String.trim(" 56322 ");//str=56322

切分字符串

• 方法：wx.String.splitAndTrim(str,spliter)
• 描述：用指定的元素分隔成字符串数组, 并对每个元素执行trim
• 参数
  • str:字符串
  • spliter:用于拆分字符串的分隔符
• 示例：

const str=wx.String.splitAndTrim("as56, sasdsf,454sx ",",");//str=['as56', 'sasdsf', '454sx']

是否为空文件

• 方法：wx.StringUtilFn.isObjectStorageNull(str)
• 描述：是否为空文件
• 参数
  • str:字符串
• 示例：

const str=wx.StringUtilFn.isObjectStorageNull("as56, sasdsf,454sx ");//str=false

转为字符串

• 方法：wx.String.toStr(str)
• 描述：转换成字符串，null、undefined转换成空字符串
• 参数
  • str:字符串
• 示例：

const str=wx.String.toStr(null);//str=""

转为整数

• 方法：wx.String.toInt(str,default)
• 描述：字符串转换成整数
• 参数
  • str:字符串
  • default:转化失败默认值
• 示例：

const str=wx.String.toFloat("123");//str=123

转为小数

• 方法：wx.String.toFloat(str,default)
• 描述：字符串转换成带小数的数值
• 参数
  • str:字符串
  • default:转化失败默认值
• 示例：

const str=wx.String.toFloat("1.23");//str=1.23

数值转字符串

• 方法：wx.String.fromFloat(num,i)
• 描述：数值转为字符,保留指定位数小数
• 参数
  • num:字符串
  • i:小数位数
• 示例：

const str=wx.String.toFloat(1.233652,2);//str=1.23

补零

• 方法：wx.String.zeros(str,len,right)
• 描述：在字符串的开头或者结尾加上几个零,达到设置的长度
• 参数
  • str:字符串
  • len:长度(Integer)
  • right:右补零(Boolean)
• 示例：

const str=wx.String.zeros("1.23",5);//str='01.23'

首字母大写

• 方法：wx.String.camelize(str)
• 描述：字符串首字母大写，其余小写
• 参数
  • str:字符串
• 示例：

const str=wx.String.zeros("asd");//str=Asd

字符串截取

• 方法：wx.String.substring(str,start,stop)
• 描述：字符串截取
• 参数
  • str:字符串
  • start:截取开始位置
  • stop:截取结束位置
• 示例：

const str=wx.String.substring("asbghskd",0,2);//str=as

是否为空

• 方法：wx.StringUtilFn.isBlank(seq)
• 描述：判断字符串是否为空或null
• 参数
  • seq:字符串
• 示例：

const str=wx.StringUtilFn.isBlank("asd");//str=false

首字母小写

• 方法：wx.StringUtilFn.unCapitalize(str)
• 描述：首字母小写
• 参数
  • str:字符串
• 示例：

const str=wx.StringUtilFn.unCapitalize("AA");//str=aA

转为小写

• 方法：wx.StringUtilFn.toLowercase(str)
• 描述：将所有的英文字符转换为小写字母
• 参数
  • input:字符串
• 示例：

const str=wx.StringUtilFn.toLowercase("aAd");//str=asd

转为大写

• 方法：wx.StringUtilFn.toUpperCase(str)
• 描述：将所有的英文字符转换为大写字母
• 参数
  • input:字符串
• 示例：

const str=wx.StringUtilFn.toUpperCase("aAd");//str=AAD

转为汉字

• 方法：wx.StringUtilFn.trans2Chinese(input)
• 描述：将数字转换为汉字
• 参数
  • input:数字
• 示例：

const str=wx.StringUtilFn.trans2Chinese(123);//str='壹佰贰拾叁元整'

是否包含

• 方法：wx.StringUtilFn.contains(seq,searchChar)
• 描述：是否包含指定字符
• 参数
  • seq:字符串
  • searchChar:包含字符串
• 示例：

const str=wx.StringUtilFn.contains("aAd,aaa","aaa");//str=true

查找首次出现位置

• 方法：wx.StringUtilFn.indexOf(seq,searchChar)
• 描述：从字符串对象中返回首个被发现的给定值的索引值，如果没有找到则返回-1
• 参数
  • seq:字符串
  • searchChar:查找字符串
• 示例：

const str=wx.StringUtilFn.indexOf("aAd","A");//str=1

查找末次出现位置

• 方法：wx.StringUtilFn.lastIndexOf(seq,searchChar)
• 描述：从字符串对象中返回最后一个被发现的给定值的索引值，如果没有找到则返回-1
• 参数
  • seq:字符串
  • searchChar:查找字符串
• 示例：

const str=wx.StringUtilFn.lastIndexOf("aAd","A");//str=1

以指定字符串结束

• 方法：wx.StringUtilFn.endsWith(seq,suffix)
• 描述：是否以指定字符串结束
• 参数
  • seq:字符串
  • suffix:结束字符串
• 示例：

const str=wx.StringUtilFn.endsWith("aAd","aa");//str=false

以指定字符串开始

• 方法：wx.StringUtilFn.startsWith(seq,prefix)
• 描述：以指定字符串开始
• 参数
  • seq:字符串
  • prefix:开始字符串
• 示例：

const str=wx.StringUtilFn.startsWith("aAd","aA");//str=true

是否为数字

• 方法：wx.StringUtilFn.isNumber(seq)
• 描述：判断字符串是否为数字
• 参数
  • seq:字符串
• 示例：

const str=wx.StringUtilFn.isNumber("11");//str=true

字符串替换

• 方法：wx.StringUtilFn.replace(seq,searchString,replacement)
• 描述：将字符串中的查找字符串替换为替换字符串
• 参数
  • seq:字符串
  • searchString:查找字符串
  • replacement:替换字符串
• 示例：

const str=wx.StringUtilFn.replace("aAd","aA","123");//str='123d'

日期时间函数

是否闰年

• 方法：wx.Date.isLeapYear(date)
• 描述：判断是否闰年
• 参数
  • date:时间
• 示例：

const str=wx.Date.isLeapYear(new Date());//str=false

字符串转为时间

• 方法：wx.Date.fromString
• 描述：按照给定的时间格式，把字符串转换成时间对象
• 参数
  • seq:时间字符串
  • format:时间格式
• 示例：

const str=wx.Date.fromString("2025/04/22","yyyy/MM/dd");//str=Tue Apr 22 2025 00:00:00 GMT+0800 (中国标准时间)

时间转为字符串

• 方法：wx.Date.toString(dateTime,format)
• 描述：按照给定的时间格式，把时间对象转换成字符串
• 参数
  • seq:字符串
  • searchString:查找字符串
  • replacement:替换字符串
• 示例：

const str=wx.Date.toString(new Date(),"yyyy/MM/dd");//str='2025/04/22'

时间加

• 方法：wx.Date.increase(dateTime,num,replacement)
• 描述：为给定的时间按时间单位增加指定的时间量。单位可以是年、月、日、时、分、秒、季、周
• 参数
  • dateTime:时间
  • num:增量（Integer）
  • interval:时间单位
• 示例：

const str=wx.Date.increase(new Date(),1,wx.Date.UNIT_DAY);//str=Wed Apr 23 2025 15:16:16 GMT+0800 (中国标准时间)

时间减

• 方法：wx.Date.decrease(dateTime,num,replacement)
• 描述：为给定的时间按时间单位减少指定的时间量。单位可以是年、月、日、时、分、秒、季、周
• 参数
  • dateTime:时间
  • num:增量（Integer）
  • interval:时间单位
• 示例：

const str=wx.Date.decrease(new Date(),1,wx.Date.UNIT_DAY);//str=Wed Apr 21 2025 15:16:16 GMT+0800 (中国标准时间)

时间间隔

• 方法：wx.Date.diff(start,end,interval)
• 描述：计算结束时间与开始时间的差，单位可以是年、月、日、时、分、秒、季
• 参数
  • start:开始时间
  • end:结束时间
  • interval:时间单位
• 示例：

const str=wx.Date.diff(wx.Date.fromString("2025/04/22","yyyy/MM/dd"),wx.Date.fromString("2025/04/25","yyyy/MM/dd"),wx.Date.UNIT_DAY);//str=3

相隔的天数

• 方法：wx.Date.between(start,end)
• 描述：计算结束时间与开始时间相差天数，返回永远是正整数
• 参数
  • start:开始时间
  • end:结束时间
• 示例：

const str=wx.Date.between(wx.Date.fromString("2025/04/28","yyyy/MM/dd"),wx.Date.fromString("2025/04/25","yyyy/MM/dd"));//str=3

当前时间

• 方法：wx.Date.now()
• 描述：获取当前时间
• 示例：

const str=wx.Date.now();//str=Tue Apr 22 2025 15:21:51 GMT+0800 (中国标准时间)

服务器时间

• 方法：wx.Date.getServerDatetime()
• 描述：获取服务器时间
• 示例：

const str=wx.Date.getServerDatetime();//str=Tue Apr 22 2025 15:22:54 GMT+0800 (中国标准时间)

月第一天

• 方法：wx.Date.getFirstDay(dateTime)
• 描述：获取时间所在月的第一天，不设置参数时，取当前月的第一天
• 参数
  • dateTime:时间
• 示例：

const str=wx.Date.getFirstDay();//str=Tue Apr 01 2025 00:00:00 GMT+0800 (中国标准时间)

月最后一天

• 方法：wx.Date.getLastDay(dateTime)
• 描述：获取时间所在月的最后一天的23点59分59秒，不设置参数时，取当前月的最后一天的23点59分59秒
• 参数
  • dateTime:时间
• 示例：

const str=wx.Date.getLastDay();//str=Wed Apr 30 2025 23:59:59 GMT+0800 (中国标准时间)

毫秒数转为时间

• 方法：wx.DateTimeUtilFn.parse(millis)
• 描述：将毫秒数转换为时间
• 参数
  • millis:毫秒数
• 示例：

const str=wx.DateTimeUtilFn.parse(1745306886791);//str=Tue Apr 22 2025 15:28:06 GMT+0800 (中国标准时间)

获取年份

• 方法：wx.DateTimeUtilFn.getFullYear(dateTime)
• 描述：获取时间中的年份
• 参数
  • dateTime:时间
• 示例：

const str=wx.DateTimeUtilFn.getFullYear(new Date());//str=2025

获取月份

• 方法：wx.DateTimeUtilFn.getMonth(dateTime)
• 描述：获取时间中的月份（1-12）
• 参数
  • dateTime:时间
• 示例：

const str=wx.DateTimeUtilFn.getMonth(new Date());//str=4

获取周数

• 方法：wx.DateTimeUtilFn.getDay(dateTime)
• 描述：根据本地时间返回指定时间对象的星期中的第几天（0-6）
• 参数
  • dateTime:时间
• 示例：

const str=wx.DateTimeUtilFn.getDay(new Date());//str=2

获取星期几

• 方法：wx.DateTimeUtilFn.getDayForChinese(dateTime)
• 描述：根据本地时间返回指定时间对象的星期几
• 参数
  • dateTime:时间
• 示例：

const str=wx.DateTimeUtilFn.getDayForChinese(new Date());//str='星期二'

获取天数

• 方法：wx.DateTimeUtilFn.getDate(dateTime)
• 描述：根据本地时间返回指定时间对象的月份中的第几天（1-31）
• 参数
  • dateTime:时间
• 示例：

const str=wx.DateTimeUtilFn.getDate(new Date());//str=22

获取小时

• 方法：wx.DateTimeUtilFn.getHour(dateTime)
• 描述：获取时间中的小时数
• 参数
  • dateTime:时间
• 示例：

const str=wx.DateTimeUtilFn.getHour(new Date());//str=15

获取分钟

• 方法：wx.DateTimeUtilFn.getMinutes(dateTime)
• 描述：获取时间中的分钟数
• 参数
  • dateTime:时间
• 示例：

const str=wx.DateTimeUtilFn.getMinutes(new Date());//str=35

获取秒数

• 方法：wx.DateTimeUtilFn.getSeconds(dateTime)
• 描述：获取时间中的秒数
• 参数
  • dateTime:时间
• 示例：

const str=wx.DateTimeUtilFn.getSeconds(new Date());//str=35

获取毫秒数

• 方法：wx.DateTimeUtilFn.getTime(dateTime)
• 描述：获取时间的总毫秒数
• 参数
  • dateTime:时间
  • num:增量（Integer）
  • interval:时间单位
• 示例：

const str=wx.DateTimeUtilFn.getTime(new Date());//str=1745307456449

设置年份

• 方法：wx.DateTimeUtilFn.setFullYear(dateTime,years)
• 描述：设置时间的年份
• 参数
  • dateTime:时间
  • years:年份（Integer）
• 示例：

const str=wx.DateTimeUtilFn.setFullYear(new Date(),2011);//str=Fri Apr 22 2011 15:39:00 GMT+0800 (中国标准时间)

设置月份

• 方法：wx.DateTimeUtilFn.setMonth(dateTime,month)
• 描述：设置时间的年份
• 参数
  • dateTime:时间
  • month:月份（Integer）
• 示例：

const str=wx.DateTimeUtilFn.setMonth(new Date(),9);//str=Mon Sep 22 2025 15:40:15 GMT+0800 (中国标准时间)

设置天数

• 方法：wx.DateTimeUtilFn.setDate(dateTime,day)
• 描述：设置时间的天
• 参数
  • dateTime:时间
  • day:一个整数，表示该月的第几天
• 示例：

const str=wx.DateTimeUtilFn.setDate(new Date(),22);//str=Tue Apr 22 2025 15:41:21 GMT+0800 (中国标准时间)

设置小时数

• 方法：wx.DateTimeUtilFn.setHours(dateTime,hoursValue)
• 描述：设置时间的年份
• 参数
  • dateTime:时间
  • hoursValue:小时数（Integer）
• 示例：

const str=wx.DateTimeUtilFn.setHours(new Date(),20);//str=Tue Apr 22 2025 20:42:35 GMT+0800 (中国标准时间)

设置分钟数

• 方法：wx.DateTimeUtilFn.setMinute(dateTime,minutes)
• 描述：设置时间的分钟数
• 参数
  • dateTime:时间
  • minutes:分钟数（Integer）
• 示例：

const str=wx.DateTimeUtilFn.setMinute(new Date(),59);//str=Fri Apr 22 2011 15:59:00 GMT+0800 (中国标准时间)

设置秒数

• 方法：wx.DateTimeUtilFn.setSeconds(dateTime,seconds)
• 描述：设置时间的年份
• 参数
  • dateTime:时间
  • seconds:秒数（Integer）
• 示例：

const str=wx.DateTimeUtilFn.setSeconds(new Date(),56);//str=Fri Apr 22 2011 15:39:56 GMT+0800 (中国标准时间)

加/减年

• 方法：wx.DateTimeUtilFn.plusYears(dateTime,years)
• 描述：增加/减少指定年数,年数为正时增加，反之减少,如：年数为1表示加一年,-1为减一年
• 参数
  • dateTime:时间
  • years:年数（Integer）
• 示例：

const str=wx.DateTimeUtilFn.plusYears(new Date(),2);//str=Thu Apr 22 2027 15:45:15 GMT+0800 (中国标准时间)

加/减月

• 方法：wx.DateTimeUtilFn.plusMonths(dateTime,month)
• 描述：增加/减少指定月数,月数为正时增加，反之减少,如：月数为1表示加1月,-1为减1月
• 参数
  • dateTime:时间
  • month:月数（Integer）
• 示例：

const str=wx.DateTimeUtilFn.plusMonths(new Date(),3);//str=Tue Jul 22 2025 15:46:19 GMT+0800 (中国标准时间)

加/减小时

• 方法：wx.DateTimeUtilFn.plusHours(dateTime,hours)
• 描述：增加/减少指定小时数,小时数为正时增加，反之减少,如：小时数为1表示加1小时,-1为减1小时
• 参数
  • dateTime:时间
  • hours:小时数（Integer）
• 示例：

const str=wx.DateTimeUtilFn.plusHours(new Date(),-3);//str=Tue Apr 22 2025 12:47:39 GMT+0800 (中国标准时间)

加/减天

• 方法：wx.DateTimeUtilFn.plusDates(dateTime,days)
• 描述：增加/减少指定天数,天数为正时增加，反之减少,如：天数为1表示加1天,-1为减1天
• 参数
  • dateTime:时间
  • days:天数（Integer）
• 示例：

const str=wx.DateTimeUtilFn.plusDates(new Date(),3);//str=Fri Apr 25 2025 16:01:51 GMT+0800 (中国标准时间)

加/减分钟

• 方法：wx.DateTimeUtilFn.plusMinutes(dateTime,minutes)
• 描述：增加/减少指定分钟数,分钟数为正时增加，反之减少,如：分钟数为1表示加1分钟,-1为减1分钟
• 参数
  • dateTime:时间
  • minutes:分钟数（Integer）
• 示例：

const str=wx.DateTimeUtilFn.plusMinutes(new Date(),-3);//str=Tue Apr 22 2025 15:59:51 GMT+0800 (中国标准时间)

加/减秒

• 方法：wx.DateTimeUtilFn.plusSeconds(dateTime,seconds)
• 描述：增加/减少指定秒数,秒数为正时增加，反之减少,如：秒数为1表示加1秒,-1为减1秒
• 参数
  • dateTime:时间
  • seconds:秒数（Integer）
• 示例：

const str=wx.DateTimeUtilFn.plusSeconds(new Date(),-33);//str=Tue Apr 22 2025 16:03:25 GMT+0800 (中国标准时间)

加/减毫秒

• 方法：wx.DateTimeUtilFn.plus(dateTime,month)
• 描述：增加/减少指定毫秒数,毫秒数为正时增加，反之减少,如：毫秒数为1表示加1毫秒,-1为减1毫秒
• 参数
  • dateTime:时间
  • month:月数（Integer）
• 示例：

const str=wx.DateTimeUtilFn.plus(new Date(),-15000);//str=Tue Apr 22 2025 16:04:42 GMT+0800 (中国标准时间)

到现在的年份

• 方法：wx.DateTimeUtilFn.fromNowYears(dateTime)
• 描述：到现在的年份
• 参数
  • dateTime:时间
• 示例：

const str=wx.DateTimeUtilFn.fromNowYears(new Date());//str=0

到现在的月份

• 方法：wx.DateTimeUtilFn.fromNowMonths(dateTime)
• 描述：到现在的月份
• 参数
  • dateTime:时间
• 示例：

const str=wx.DateTimeUtilFn.fromNowMonths(new Date("2025-1-1"));//str=3

到现在的天数

• 方法：wx.DateTimeUtilFn.fromNowDays(dateTime)
• 描述：到现在的天数
• 参数
  • dateTime:时间
• 示例：

const str=wx.DateTimeUtilFn.fromNowDays(new Date("2025-1-1"));//str=111

到现在的分钟数

• 方法：wx.DateTimeUtilFn.fromNowMinutes(dateTime)
• 描述：到现在的分钟数
• 参数
  • dateTime:时间
• 示例：

const str=wx.DateTimeUtilFn.fromNowMinutes(new Date("2025-1-1"));//str=160808

到现在的秒数

• 方法：wx.DateTimeUtilFn.fromNowSeconds(dateTime)
• 描述：到现在的秒数
• 参数
  • dateTime:时间
• 示例：

const str=wx.DateTimeUtilFn.fromNowSeconds(new Date("2025-1-1"));//str=9648548

相隔年数

• 方法：wx.DateTimeUtilFn.yearsBetween(start,end)
• 描述：计算结束时间与开始时间相差年数
• 参数
  • start:开始时间
  • end:结束时间
• 示例：

const str=wx.DateTimeUtilFn.yearsBetween(new Date("2015-1-1"),new Date("2025-1-1"));//str=10

相隔月份

• 方法：wx.DateTimeUtilFn.monthsBetween(start,end)
• 描述：计算结束时间与开始时间相差月份数
• 参数
  • start:开始时间
  • end:结束时间
• 示例：

const str=wx.DateTimeUtilFn.monthsBetween(new Date("2015-1-1"),new Date("2025-1-1"));//str=120

相隔天数

• 方法：wx.DateTimeUtilFn.daysBetween(start,end)
• 描述：计算结束时间与开始时间相差天数
• 参数
  • start:开始时间
  • end:结束时间
• 示例：

const str=wx.DateTimeUtilFn.daysBetween(new Date("2015-1-1"),new Date("2025-1-1"));//str=3653

相隔小时数

• 方法：wx.DateTimeUtilFn.hoursBetween(start,end)
• 描述：计算结束时间与开始时间相差小时数
• 参数
  • start:开始时间
  • end:结束时间
• 示例：

const str=wx.DateTimeUtilFn.hoursBetween(new Date("2015-1-1"),new Date("2025-1-1"));//str=87672

相隔分钟数

• 方法：wx.DateTimeUtilFn.minutesBetween(start,end)
• 描述：计算结束时间与开始时间相差分钟数
• 参数
  • start:开始时间
  • end:结束时间
• 示例：

const str=wx.DateTimeUtilFn.minutesBetween(new Date("2015-1-1"),new Date("2025-1-1"));//str=5260320

相隔秒数

• 方法：wx.DateTimeUtilFn.secondsBetween(start,end)
• 描述：计算结束时间与开始时间相差秒数
• 参数
  • start:开始时间
  • end:结束时间
• 示例：

const str=wx.DateTimeUtilFn.secondsBetween(new Date("2015-1-1"),new Date("2025-1-1"));//str=315619200

日期时间函数相关常量

wx.Date.STANDART_FORMAT:格式:yyyy-MM-ddThh:mm:ss.fffZ wx.Date.DEFAULT_FORMAT:格式:yyyy/MM/dd hh:mm:ss wx.Date.DEFAULT_FORMAT1:格式:yyyy-MM-dd hh:mm:ss wx.Date.STANDART_FORMAT_SHOT:格式:yyyy-MM-dd wx.Date.DEFAULT_FORMAT_SHOT:格式:yyyy/MM/dd wx.Date.UNIT_YEAR:时间单位年,值:y wx.Date.UNIT_QUARTER:时间单位季度,值:q wx.Date.UNIT_MONTH:时间单位月,值:m wx.Date.UNIT_WEEK:时间单位周,值:w wx.Date.UNIT_DAY:时间单位天,值:d wx.Date.UNIT_HOUR:时间单位小时,值:h wx.Date.UNIT_MINUTE:时间单位分钟,值:n wx.Date.UNIT_SECOND:时间单位秒,值:s

编码函数

Base64编码

• 方法：wx.Base64.encode(str)
• 描述：Base64编码
• 参数
  • str:字符串
• 示例：

const str=wx.Base64.encode("http://entrylzsdev6-lzsdev-ide.trunk2.xcaas.com:8800/");//str='aHR0cDovL2VudHJ5bHpzZGV2Ni1senNkZXYtaWRlLnRydW5rMi54Y2Fhcy5jb206ODgwMC8='

Base64解码

• 方法：wx.Base64.decode(str)
• 描述：Base64解码
• 参数
  • str:字符串
• 示例：

const str=wx.Base64.decode("aHR0cDovL2VudHJ5bHpzZGV2Ni1senNkZXYtaWRlLnRydW5rMi54Y2Fhcy5jb206ODgwMC8=");//str='http://entrylzsdev6-lzsdev-ide.trunk2.xcaas.com:8800/'

URL解码

• 方法：wx.UrlUtilFn.decodeURIComponent(str)
• 描述：对encodeURIComponent()函数编码的URI进行解码
• 参数
  • str:字符串
• 示例：

const str=wx.UrlUtilFn.decodeURIComponent("http%3A%2F%2Fentrylzsdev6-lzsdev-ide.trunk2.xcaas.com%3A8800%2Fx5%2FUI2%2Fv_%2Fsystem%2Fdesigner%2FwebIde%2FappMaker%2Findex.w");//str=http://entrylzsdev6-lzsdev-ide.trunk2.xcaas.com:8800/x5/UI2/v_/system/designer/webIde/appMaker/index.w

URL编码

• 方法：wx.UrlUtilFn.encodeURIComponent(str)
• 描述：把字符串作为URI组件进行编码
• 参数
  • str:开始时间
• 示例：

const str=wx.UrlUtilFn.encodeURIComponent("http://entrylzsdev6-lzsdev-ide.trunk2.xcaas.com:8800/x5/UI2/v_/system/designer/webIde/appMaker/index.w");//str='http%3A%2F%2Fentrylzsdev6-lzsdev-ide.trunk2.xcaas.com%3A8800%2Fx5%2FUI2%2Fv_%2Fsystem%2Fdesigner%2FwebIde%2FappMaker%2Findex.w'

加密函数

MD5加密

• 方法：wx.EncryptUtilFn.md5(str)
• 描述：MD5加密
• 参数
  • str:字符串
• 示例：

const str=wx.EncryptUtilFn.md5("http://entrylzsdev6-lzsdev-ide.trunk2.xcaas.com:8800/");//str='e116d801a2719db07f7eb57194c7b68c'

数学函数

绝对值

• 方法：wx.MathUtilFn.abs(number)
• 描述：取绝对值
• 参数
  • number:数值
• 示例：

const str=wx.MathUtilFn.abs(-3652);//str=3652

向上取整

• 方法：wx.MathUtilFn.ceil(number)
• 描述：取大于数值的最小整数
• 参数
  • number:数值
• 示例：

const str=wx.MathUtilFn.ceil(1.233656);//str=2

向下取整

• 方法：wx.MathUtilFn.floor(number)
• 描述：取小于数值的最大整数
• 参数
  • number:数值
• 示例：

const str=wx.MathUtilFn.floor(1.2);//str=1

最大值

• 方法：wx.MathUtilFn.max(number1,number2)
• 描述：比较两个数值，返回最大值
• 参数
  • number1:数值
  • number2:数值
• 示例：

const str=wx.MathUtilFn.max(-3652,36);//str=36

最小值

• 方法：wx.MathUtilFn.min(number)
• 描述：比较两个数值，返回最小值
• 参数
  • number:数值
• 示例：

const str=wx.MathUtilFn.min(-3652,36);//str=3652

四舍五入

• 方法：wx.MathUtilFn.round(number)
• 描述：返回数值四舍五入的结果
• 参数
  • number:数值
• 示例：

const str=wx.MathUtilFn.round(1.365245);//str=1

保留小数位数

• 方法：wx.MathUtilFn.roundDecimal(number,i)
• 描述：取绝对值
• 参数
  • number:数值
  • i:小数位数
• 示例：

const str=wx.MathUtilFn.roundDecimal(1.3521,3);//str=1.352

平方根

• 方法：wx.MathUtilFn.sqrt(number)
• 描述：返回平方根
• 参数
  • number:数值
• 示例：

const str=wx.MathUtilFn.sqrt(16);//str=4

集合相关函数

是否包含元素

• 方法：wx.CollectionUtilFn.contains(array,ele)
• 描述：是否包含元素
• 参数
  • array:集合
  • ele:元素（对象）
• 示例：

const str=wx.CollectionUtilFn.contains([5,6,3],3);//str=true

是否空集合

• 方法：wx.CollectionUtilFn.isEmpty(array)
• 描述：是否为空集合
• 参数
  • array:集合
• 示例：

const str=wx.CollectionUtilFn.isEmpty([5,6,3]);//str=false

是否非空集合

• 方法：wx.CollectionUtilFn.isNotEmpty(array)
• 描述：是否非空集合
• 参数
  • array:集合
• 示例：

const str=wx.CollectionUtilFn.isNotEmpty([5,6,3]);//str=true

集合元素数

• 方法：wx.CollectionUtilFn.length(array)
• 描述：是否包含元素
• 参数
  • array:集合
• 示例：

const str=wx.CollectionUtilFn.length([5,6,3]);//str=3

集合最大元素

• 方法：wx.CollectionUtilFn.max(array)
• 描述：集合最大元素
• 参数
  • array:集合
• 示例：

const str=wx.CollectionUtilFn.max([5,6,3]);//str=6

集合最小元素

• 方法：wx.CollectionUtilFn.min(array)
• 描述：集合最小元素
• 参数
  • array:集合
• 示例：

const str=wx.CollectionUtilFn.min([5,6,3]);//str=3

集合第一个元素

• 方法：wx.CollectionUtilFn.getFirst(array,ele)
• 描述：集合中的第一个元素
• 参数
  • array:集合
  • ele:元素（对象）
• 示例：

const str=wx.CollectionUtilFn.getFirst([5,6,3]);//str=5

集合最后一个元素

• 方法：wx.CollectionUtilFn.getLast(array,ele)
• 描述：集合中的最后一个元素
• 参数
  • array:集合
• 示例：

const str=wx.CollectionUtilFn.getLast([5,6,3]);//str=3

集合元素

• 方法：wx.CollectionUtilFn.get(array,idx)
• 描述：集合中指定索引的元素
• 参数
  • array:集合
  • idx:索引
• 示例：

const str=wx.CollectionUtilFn.get([5,6,3],1);//str=6

随机数函数

随机整数

• 方法：wx.RandomUtilFn.randomInt(count)
• 描述：创建一个整数
• 参数
  • count:长度
• 示例：

const str=wx.RandomUtilFn.randomInt(5);//str=28542

随机小数

• 方法：wx.RandomUtilFn.random()
• 描述：创建一个0到1之间的小数，不包含1
• 示例：

const str=wx.RandomUtilFn.random();//str=0.46491799866653827

随机字符串 (字母数字组合)

• 方法：wx.RandomUtilFn.randomString(count)
• 描述：创建一个指定长度的字母和数字的随机组合字符串
• 参数
  • count:长度
• 示例：

const str=wx.RandomUtilFn.randomString(5);//str='D46m6'

随机字符串 （纯字母）

• 方法：wx.RandomUtilFn.randomAlphabetic(count)
• 描述：创建一个指定长度的字母随机字符串
• 参数
  • count:长度
• 示例：

const str=wx.RandomUtilFn.randomAlphabetic(5);//str='KivsR'

随机字符串 （纯数字）

• 方法：wx.RandomUtilFn.randomNumber(count)
• 描述：创建一个随机数字字符串
• 参数
  • count:长度
• 示例：

const str=wx.RandomUtilFn.randomNumber(5);//str='91589'

运行环境函数

调用组件方法

• 方法：wx.CommonUtilFn.callCompFn(page,id,fnName)
• 描述：调用 组件方法
• 参数
  • page:页面对象
  • id:组件id
  • fnName:方法名
• 示例：

wx.CommonUtilFn.callCompFn(this,"dialog0","open");;

是否是X5App环境

• 方法：wx.Device.isX5App()
• 描述：判断当前是否是X5App环境
• 示例：

const str=wx.Device.isX5App();//str=false

是否是小程序环境

• 方法：wx.Device.isMiniProgram()
• 描述：判断当前是否是小程序环境
• 示例：

const str=wx.Device.isMiniProgram();//str=false

是否是浏览器环境

• 方法：wx.Device.isBroswer()
• 描述：判断当前是否是浏览器环境
• 示例：

const str=wx.Device.isBroswer();//str=true

是否是模拟环境

• 方法：wx.Device.isSimulate()
• 描述：判断当前是否是模拟环境
• 示例：

const str=wx.Device.isSimulate();//str=undefined

字符串校验函数

编码检查

• 方法：wx.Util.testCode(val)
• 描述：以字母开头且只包含字母及数字检查
• 参数
  • val:字符串
• 示例：

const str=wx.Util.testCode("aA563");//str=true

Email格式检查

• 方法：wx.Util.testEmail(val)
• 描述：Email格式检查
• 参数
  • val:字符串
• 示例：

const str=wx.Util.testEmail("as5@test.com");//str=true

固定电话号码格式检查

• 方法：wx.Util.testMobile(val)
• 描述：固定电话号码格式检查
• 参数
  • val:字符串
• 示例：

const str=wx.Util.testMobile("13008711234");//str=true

字符长度检查

• 方法：wx.Util.testLength(val,min,max)
• 描述：字符长度检查
• 参数
  • val:字符串
  • min:最小长度
  • max:最大长度
• 示例：

const str=wx.Util.testLength("as5",3,6);//str=false

身份证号码格式检查

• 方法：wx.Util.testIDCard(val)
• 描述：身份证号码格式检查
• 参数
  • val:字符串
• 示例：

const str=wx.Util.testIDCard("CB2C54C9F1E000019D6716901560C3C0");//str=false

银行卡号格式检查

• 方法：wx.Util.testBankNO(val)
• 描述：银行卡号格式检查
• 参数
  • val:字符串
• 示例：

const str=wx.Util.testBankNO("CB2C54C9F1E000019D6716901560C3C0");//str=false

其他函数

生成32位唯一码

• 方法：wx.UUID.createUUID()
• 描述：返回UUID字符串
• 示例：

const str=wx.UUID.createUUID();//str='CB2C54C9F1E000019D6716901560C3C0'

生成19位唯一码

• 方法：wx.UUID.createShortUUID()
• 描述：返回UUID字符串
• 示例：

const str=wx.UUID.createShortUUID();//str='plICcHy339yJoZtgWIS'

生成36位唯一码

• 方法：wx.UUID.createLongUUID()
• 描述：返回UUID字符串
• 示例：

const str=wx.UUID.createLongUUID();//str='CB2C54DC-84B0-0001-58A3-A27611C01D3B'

条件判断

• 方法：wx.Util.iif(condision,trueValue,falseValue)
• 描述：条件判断
• 参数
  • condision:条件
  • trueValue:满足条件返回值
  • falseValue:不满足条件返回值
• 示例：

const str=wx.Util.iif(''!=null,1,2);//str=1

数值格式检查

• 方法：wx.Util.testNumber(val)
• 描述：计算结束时间与开始时间相差秒数
• 参数
  • val:字符串
• 示例：

const str=wx.Util.testNumber("33");//str=true

整数格式检查

• 方法：wx.Util.testInteger(val)
• 描述：整数格式检查
• 参数
  • val:字符串
• 示例：

const str=wx.Util.testInteger("as5");//str=false

只允许中文检查

• 方法：wx.Util.testChinese(val)
• 描述：只允许中文检查
• 参数
  • val:字符串
• 示例：

const str=wx.Util.testChinese("测试123");//str=false

不包含特殊字符检查

• 方法：wx.Util.testNotSpecialChar(val)
• 描述：不包含特殊字符检查
• 参数
  • val:字符串
• 示例：

const str=wx.Util.testNotSpecialChar("as5");//str=true

是否布尔类型

• 方法：wx.Util.isBoolean(val)
• 描述：是否布尔类型
• 参数
  • val:对象
• 示例：

const str=wx.Util.isBoolean("true");//str=false

是否字符串类型

• 方法：wx.Util.isString(val)
• 描述：是否字符串类型
• 参数
  • val:对象
• 示例：

const str=wx.Util.isString("as5");//str=true

是否函数

• 方法：wx.Util.isFunction(val)
• 描述：是否函数
• 参数
  • val:对象
• 示例：

const str=wx.Util.isFunction(()=>{});//str=true

是否数组

• 方法：wx.Util.isArray(val)
• 描述：是否数组
• 参数
  • val:对象
• 示例：

const str=wx.Util.isArray("as5");//str=false

是否对象

• 方法：wx.Util.isObject(val)
• 描述：判断值的类型是否是Object
• 参数
  • val:字符串
  • min:最小长度
  • max:最大长度
• 示例：

const str=wx.Util.isObject({a:1});//str=true