更新记录

1.0.2（2024-01-09）

增加时间戳转时间:convertTimestamp(timestamp)

1.0.1（2023-07-20）

BUG函数更正

1.0.0（2023-07-19）

初始化1.0.0版本增加如下：

验证API函数, 应用API函数, 日期API函数, uni工具封装API函数, uni存储工具

平台兼容性

untTs 函数API文档

1、formatDate(time)

💡 Tips：格式化日期格式 (用于兼容ios Date对象)

• 参数：
  • time：DateTime类型，表示要格式化的时间。
• 返回值：格式化后的时间字符串，将"xxxx-xx-xx"的格式转换为"xxxx/xx/xx"的格式。

/* 格式化日期格式 (用于兼容ios Date对象) */
uni.$unt.formatDate("2023-01-01") ==> 2023/01/01

2、dateFormat(fmt, date)

💡 Tips：对Date的扩展，将 Date 转化为指定格式的String

• 参数：
  • fmt：字符串类型，表示要转换的日期格式。支持的格式有： "Y"：年 "m"：月 "d"：日 "H"：小时 "M"：分钟 "S"：秒
  • date：DateTime类型，表示要转换的日期对象。
• 返回值：转换后的日期字符串。

/* 对Date的扩展，将 Date 转化为指定格式的String */
uni.$unt.dateFormat('YYYY-mm-dd HH:MM:SS', new Date()) ==> 2023-01-01 06:00:00

3、nowWeek()

💡 Tips：获取当前日期星期几

• 返回值：字符串，格式为"xxxx年xx月xx日 星期X"。

/* 获取当前日期星期几 */
uni.$unt.nowWeek() ==> 2023年7月19日 星期三

4、nowDate()

💡 Tips：获取当前日期

• 返回值：字符串，格式为"xxxx-xx-xx"。

/* 获取当前日期 */
uni.$unt.nowDate() ==> 2023-7-19

5、nowTime()

💡 Tips：获取当前时间

• 返回值：字符串，格式为"HH:MM:SS"。

/* 获取当前时间 */
uni.$unt.nowTime() ==> 14:38:52

6、nowDateTime()

💡 Tips：获取当前日期和时间

• 返回值：字符串，格式为"xxxx-xx-xx HH:MM:SS"。

/* 获取当前日期和时间 */
uni.$unt.nowDateTime() => 2023-7-19 14:38:52

7、nowDateAgo(n)

💡 Tips：获取当前日期前n天的日期

• 参数：
  • n：整数类型，表示前几天。
• 返回值：字符串，格式为"xxxx-xx-xx"。

/* 获取当前日期前n天的日期 */
uni.$unt.nowDateAgo(1) ==> 2023-7-18

8、nowDateTimeAgo(n)

💡 Tips：获取当前日期时间前n天的日期时间

• 参数：
  • n：整数类型，表示前几天
• 返回值：字符串，格式为"xxxx-xx-xx HH:MM:SS"

/* 获取当前日期时间前n天的日期时间 */
uni.$unt.nowDateTimeAgo(1) ==> 2023-7-18 14:38:52

9、nowDateAgoArr(n)

💡 Tips：获取当前日期和前t天的日期数组

• 参数：
  • t：整数类型，表示前几天
• 返回值：字符串数组，包含当前日期和前t天的日期，格式为["xxxx-xx-xx", "xxxx-xx-xx"]

/* 获取当前日期和前t天的日期数组 */
uni.$unt.nowDateAgoArr(1) ==>  ["2023-7-18", "2023-7-19"]

10、nowDateTimeAgoArr(n)

💡 Tips：获取当前日期时间和前t天的日期时间数组

• 参数：
  • t：整数类型，表示前几天
• 返回值：字符串数组，包含当前日期时间和前t天的日期时间，格式为["xxxx-xx-xx HH:MM:SS", "xxxx-xx-xx HH:MM:SS"]

/* 获取当前日期时间和前t天的日期时间数组 */
uni.$unt.nowDateTimeAgoArr(1) ==>  ["2023-7-18 14:38:52", "2023-7-19 14:38:52"]

11、num2K(num)

💡 Tips：数字换算单位，将数字转换为带有单位的字符串（如1.1k、1.5w）。

• 参数：
  • num：数字类型，表示要转换的数字。
• 返回值：转换后的带有单位的字符串。

/* 数字换算单位，将数字转换为带有单位的字符串（如1.1k、1.5w） */
uni.$unt.num2K(1500) ==> 1.5k

12、num2M(num)

💡 Tips：数字换算单位，将数字转换为带有千位分隔符的字符串（如1,000）。

• 参数：
  • num：数字类型，表示要转换的数字。
• 返回值：转换后的带有千位分隔符的字符串。

/* 数字换算单位，将数字转换为带有千位分隔符的字符串（如1,000） */
uni.$unt.num2M(1000) ==> 1,000

13、random(min, max)

💡 Tips：获取指定范围内的随机数。

• 参数：
  • min：数字类型，表示随机数的最小值。
  • max：数字类型，表示随机数的最大值。
• 返回值：随机数。

/* 随机的1到10之间的数字 */
uni.$unt.random(1, 10) ==> 6

14、round(num, decimal)

💡 Tips：精确小数，将数字保留指定位数的小数。

• 参数：
  • num：数字类型，表示要精确的数字。
  • decimal：数字类型，表示要保留的小数位数，默认为15。
• 返回值：精确后的数字。

/* 精确小数，将数字保留指定位数的小数。 */
uni.$unt.round(3.14159, 2) ==> 3.14

15、trim(str, type)

💡 Tips：去除字符串中的空格。

• 参数：
  • str：表示要去除空格的字符串。
  • type（可选）：字符串类型，指定去除空白字符的方式，默认为 "both"。可选的取值有 "both"、"left"、"right" 和 "all"。
• 返回值：去除空格后的字符串。

/* 去除字符串中的空格 */
uni.$unt.trim('  Hello, World!  ', 'both') ==> Hello, World!

16、deepClone(obj1, obj2)

💡 Tips：深度拷贝对象。

• 参数：
  • obj1：对象类型，表示要拷贝的对象。
  • obj2：对象类型，表示目标对象，可选参数，默认为空对象。
• 返回值：拷贝后的对象。

/* 深度拷贝对象 */
uni.$unt.deepClone({ name: 'Alice', age: 25 },{}) ==> { name: 'Alice', age: 25 }

17、getUrlParam(url)

💡 Tips：从URL中解析出参数，并返回一个包含参数键值对的对象。

• 参数：
  • url：字符串类型，表示要解析的URL。
• 返回值：包含参数键值对的对象。

/* 从URL中解析出参数，并返回一个包含参数键值对的对象 */
uni.$unt.getUrlParam('https://example.com/?name=Alice&age=25') ==> { name: 'Alice', age: '25' }

18、getRandomId(len)

💡 Tips：获取随机的ID值。

• 参数：
  • len：数字类型，表示ID的长度，可选参数，默认为10。
• 返回值：随机生成的ID字符串。

/* 随机的8位ID字符串 */
uni.$unt.getRandomId(8) ==> x305hhp6

19、urlEncode(obj)

💡 Tips：将对象转换为URL参数字符串。

• 参数：
  • obj：对象类型，表示要转换的对象。
• 返回值：URL参数字符串。

/* 将对象转换为URL参数字符串 */
uni.$unt.urlEncode({ name: 'Alice', age: 25 }) ==> name=Alice&age=25

20、objForEach(obj, callback)

💡 Tips：遍历对象的每个属性，并对每个属性执行回调函数。

• 参数：
  • obj：对象类型，表示要遍历的对象。
  • callback：函数类型，表示对每个属性执行的回调函数，接受两个参数：属性值和属性名。
• 返回值：无。

const obj = { name: 'Alice', age: 25 };
uni.$unt.objForEach(obj, (value, key) => {
  console.log(`${key}: ${value}`);
});
// 输出：
// name: Alice
// age: 25

验证函数

💡 Tips ：该模块包含了一些常用的验证函数，用于判断字符串是否符合特定的格式或条件。

函数列表

• inValue(str): 判断字符串是否为空。
• isMobile(str): 判断字符串是否为手机号或固定电话。
• isPhone(str): 判断字符串是否为手机号。
• isEmail(str): 判断字符串是否为合法的邮箱地址。
• isNumber(str): 判断字符串是否为数值类型，包括整数和浮点数。
• isPositiveInteger(str): 判断字符串是否为正整数（只能输入数字[0-9]）。
• isInteger(str): 判断字符串是否为整数。
• isDouble(str): 判断字符串是否为浮点数。
• isIdCard(value): 判断字符串是否为身份证号码。
• isChinese(value): 判断字符串是否为中文。
• isLetter(value): 判断字符串是否为字母。
• isEnOrNum(value): 判断字符串是否只包含字母或数字。
• isUrl(value): 判断字符串是否为URL格式。
• isImage(value): 判断字符串是否为图片格式。
• isVideo(value): 判断字符串是否为视频格式。
• inObject(object): 判断对象是否为空对象。
• isObject(object): 判断值是否为对象。
• isArray(array): 判断值是否为数组。
• inArray(array): 判断数组是否为空数组。
• isEmpty(value): 判断值是否为空对象或空数组。
• itArray(search, array): 判断值值是否在数组内。

uni工具函数封装

💡 Tips ：该模块包含了一些uni弹窗和存储函数

函数列表

• success(msg, callback): 显示成功提示框
• error(msg, callback): 显示失败提示框
• toast(msg, duration = 1500, mask = true): 显示纯文字提示框

storage

• 使用方法 【
• 一、设置缓存
• string storage_set('k', 'string你好啊');
• json storage_set('k', { "b": "3" }, 2);
• array storage_set('k', [1, 2, 3]);
• boolean storage_set('k', true);
• 二、读取缓存
• 默认值 storage_get('k')
• string storage_get('k', '你好')
• json storage_get('k', { "a": "1" })
• 三、移除/清理
• 移除: storage_remove('k');
• 清理：storage_clear();
• 】