更新记录

1.0.0（2025-08-31） 下载此版本

• 初始版本发布
• 数据验证模块：isPhone, isEmail, isIdCard, isEmpty, isInRange
• 日期处理模块：formatDate, getRelativeTime, getDaysDiff
• 设备信息模块：getPlatform, isApp, isMiniProgram, isH5
• 字符串处理模块：randomString, maskString, capitalizeFirstLetter
• 业务工具模块：deepClone, debounce, throttle, formatMoney
• TypeScript 类型定义文件
• 完整使用文档

平台兼容性

云端兼容性

uni-app(4.07)

uni-app x(4.07)

其他

hy-utils-plus

一个集成了常用工具函数的 uni-app 插件，支持多端使用。

安装

方式一：通过 HBuilderX 插件市场安装

1. 在 插件市场 搜索 hy-utils-plus
2. 点击“使用 HBuilderX 导入插件”

方式二：手动安装

1. 将 uni_modules 文件夹下的 hy-utils-plus 目录拷贝到你的项目 uni_modules 目录下
2. 重新运行项目

使用说明

全量引入（推荐）

// 在主文件（如 main.js）中引入
import Utils from '@/uni_modules/hy-utils-plus/js_sdk****/index.js';

// 挂载到 Vue 原型上，方便全局使用（可选）
Vue.prototype.$utils = Utils;

// 或在页面/组件中直接引入使用
import Utils from '@/uni_modules/hy-utils-plus/js_sdk/index.js';

export default {
  methods: {
    testUtils() {
      console.log(Utils.validate.isPhone('***'));
      console.log(Utils.date.formatDate(new Date()));
    }
  }
}

按需引入

// 只引入需要的模块
import { validate, date } from '@/uni_modules/hy-utils-plus/js_sdk/index.js';
// 或直接引入具体文件
import { isPhone } from '@/uni_modules/hy-utils-plus/js_sdk/modules/validate.js';

export default {
  methods: {
    checkPhone(phone) {
      return isPhone(phone);
    }
  }
}

API 文档

数据验证 (validate)

• isPhone(phone)：验证手机号
• isEmail(email)：验证邮箱
• isIdCard(idCard)：验证身份证号（简单版）
• isEmpty(str)：验证字符串是否为空
• isInRange(num, min, max)：验证数字范围

日期处理 (date)

• formatDate(date, format)：格式化日期
• getRelativeTime(time)：获取相对时间字符串
• getDaysDiff(date1, date2)：计算两个日期天数差

设备信息 (device)

• getPlatform()：获取当前运行环境
• isApp()：判断是否是APP
• isMiniProgram()：判断是否是小程序
• isH5()：判断是否是H5

字符串处理 (string)

• randomString(length)：生成随机字符串
• maskString(str, start, end, mask)：字符串脱敏
• capitalizeFirstLetter(str)：首字母大写

业务工具 (business/common)

• deepClone(obj)：深度克隆
• debounce(func, wait)：函数防抖
• throttle(func, limit)：函数节流
• formatMoney(cents)：金额格式化（分转元）

示例

<template>
  <view>
    <button @click="testTools">测试工具函数</button>
  </view>
</template>

<script>
import Utils from '@/uni_modules/hy-utils-plus/js_sdk/index.js';

export default {
  methods: {
    testTools() {
      // 验证手机号
      console.log('手机号验证:', Utils.validate.isPhone('***'));

      // 格式化日期
      console.log('当前时间:', Utils.date.formatDate(new Date(), 'YYYY年MM月DD日 HH:mm'));

      // 获取运行环境
      console.log('运行环境:', Utils.device.getPlatform());

      // 生成随机字符串
      console.log('随机字符串:', Utils.string.randomString(8));

      // 金额格式化
      console.log('金额格式化:', Utils.business.formatMoney(1999)); // 19.99
    }
  }
}
</script>

更新日志

详见 changelog.md

技术支持

如有问题或建议，请在插件市场页面留言。

版权信息

MIT License