@ivujs/i-utils 2.1.0 → 2.1.1

package/dist/lib/index.full.umd.js

@@ -1,5 +1,5 @@
 /*!
- * @ivujs/i-utils v2.1.0
+ * @ivujs/i-utils v2.1.1
  * Copyright 2021-2026, <gao911222@163.com>
  * Released under the MIT License.
  */
@@ -10,7 +10,16 @@
 })(this, (function (exports) { 'use strict';
 
     /**
-     * 排序
+     * 排序相关常量配置（全局只读）
+     *
+     * DESC: 降序
+     *  - 取值：0
+     *
+     * ASC: 升序
+     *  - 取值：1
+     *
+     * RANDOM: 随机排序
+     *  - 取值：2
      */
     const SORT = {
         // 降序
@@ -22,7 +31,15 @@
     };
 
     /**
-     * 数学
+     * 数学计算相关常量配置（全局只读）
+     *
+     * ROUND: 正常四舍五入
+     *  - 取值：0
+     *  - 示例：1.354保留两位是1.35；1.355保留两位是1.36
+     *
+     * ROUND_FLOOR: 向下舍出
+     *  - 取值：1
+     *  - 示例：1.354保留两位是1.35；1.355保留两位是1.35
      */
     const MATH = {
         // 正常四舍五入，如：1.354保留两位是1.35；1.355保留两位是1.36；
@@ -32,7 +49,13 @@
     };
 
     /**
-     * 语言
+     * 语言相关常量配置（全局只读）
+     *
+     * ZH: 中文
+     *  - zh
+     *
+     * EN: 英文
+     *  - en
      */
     const LANG = {
         // 中文
@@ -42,27 +65,50 @@
     };
 
     /**
-     * 正则
+     * 正则表达式相关常量配置（全局只读）
+     *
+     * CH: 中文汉字
+     * EN: 英文字母
+     * LOWER_CASE: 小写字母
+     * UPPER_CASE: 大写字母
+     * CH_NAME: 中文姓名（2-16位）
+     * EN_NAME: 英文姓名（1-20位）
+     * NUMBER: 数字（包含正数和负数）
+     * INTEGER: 整数（包含：0，正整数和负整数）
+     * DECIMAL: 小数（包含正小数和负小数）
+     * INT_OR_FLOAT: 正整数或者保留两位小数
+     * MOBILE: 手机号码（支持+86）
+     * PHONE: 固定电话号码（比如：0755-1111111）
+     * EMAIL: 邮箱
+     * ID_CARD: 一代15位或二代18位身份证
+     * ID_CARD15: 仅校验一代15位身份证
+     * ID_CARD18: 仅校验二代18位身份证
+     * BANK_CARD: 银行卡号
+     * POST_CODE: 邮政编码
+     * URL: url地址（可获取主机地址、主机名、端口号、协议、查询参数、hash等信息）
+     * IP: ip地址
+     * IP6: IPv6地址
+     * EXTERNAL: 外链（http、https、mail、tel电话）
      */
     const REGEXP = {
         // 中文汉字
         CH: /^[\u4E00-\u9FA5]+$/,
-        // 英文字母
-        EN: /^[a-zA-Z]$/,
+        // 英文字母,1个以上
+        EN: /^[a-zA-Z]+$/,
         // 小写字母
         LOWER_CASE: /^[a-z]+$/,
         // 大写字母
         UPPER_CASE: /^[A-Z]+$/,
-        // 中文姓名，2-16位
+        // 中文姓名，2-16位（支持少数民族姓名间隔符「·」）
         CH_NAME: /^[\u4e00-\u9fa5·]{2,16}$/,
-        // 英文姓名，0-20位
-        EN_NAME: /(^[a-zA-Z][a-zA-Z\s]{0,20}[a-zA-Z]$)/,
+        // 英文姓名，1-20位
+        EN_NAME: /^[a-zA-Z\s]{1,20}$/,
         // 数字，包含正数和负数
         NUMBER: /^([-+])?\d+(\.\d+)?$/,
         // 整数，包含：0，正整数和负整数
         INTEGER: /^(0|[1-9][0-9]*|-[1-9][0-9]*)$/,
         // 小数，包含正小数和负小数
-        DECIMAL: /^\d+\.\d+$/,
+        DECIMAL: /^([-+])?\d+\.\d+$/,
         // 正整数或者保留两位小数
         INT_OR_FLOAT: /(^[1-9][0-9]*$)|(^[1-9][0-9]*\.[0-9]{1,2}$)|(^0\.[0-9]{1,2}$)|(^0$)/,
         // 手机号码，支持+86
@@ -71,7 +117,7 @@
         PHONE: /^(?:(?:\d{3}-)?\d{8}|^(?:\d{4}-)?\d{7,8})(?:-\d+)?$/,
         // 邮箱
         EMAIL: /^[\w-]+(\.[\w-]+)*@[\w-]+(\.[\w-]+)+$/,
-        // 一代15位和二代18位身份证
+        // 一代15位或二代18位身份证
         ID_CARD: /(^\d{8}(0\d|10|11|12)([0-2]\d|30|31)\d{3}$)|(^\d{6}(18|19|20)\d{2}(0[1-9]|10|11|12)([0-2]\d|30|31)\d{3}(\d|X|x)$)/,
         // 仅校验一代15位身份证
         ID_CARD15: /(^\d{8}(0\d|10|11|12)([0-2]\d|30|31)\d{3}$)/,
@@ -86,13 +132,67 @@
         // ip地址
         IP: /^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/,
         // IPv6地址
-        IP6: /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/,
+        IP6: /^(([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|::([0-9a-fA-F]{1,4}:){0,6}[0-9a-fA-F]{1,4}|[0-9a-fA-F]{1,4}::([0-9a-fA-F]{1,4}:){0,5}[0-9a-fA-F]{1,4})$/i,
         // 是外链，http，https，mail，tel电话
-        EXTERNAL: /^(http?:|https?:|mailto:|tel:)/,
+        EXTERNAL: /^(http:|https:|ftp:|ftps:|mailto:|tel:)/i,
     };
 
     /**
-     * 日期
+     * 日期相关的多语言常量配置（全局只读）
+     *
+     * AM_PM: 上午/下午多语言配置
+     *  - zh: { AM: "上午", PM: "下午" }
+     *  - en: { AM: "AM", PM: "PM" }
+     *
+     * WEEK: 星期多语言配置
+     *  - zh.FULL: ["星期日", "星期一", "星期二", "星期三", "星期四", "星期五", "星期六"]
+     *  - zh.SHORT: ["周日", "周一", "周二", "周三", "周四", "周五", "周六"]
+     *  - zh.MINI: ["日", "一", "二", "三", "四", "五", "六"]
+     *  - en.FULL: ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"]
+     *  - en.SHORT: ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"]
+     *  - en.MINI: ["Su", "Mo", "Tu", "We", "Th", "Fr", "Sa"]
+     *
+     * MONTH: 月份多语言配置
+     *  - zh.FULL: ["一月", "二月", "三月", "四月", "五月", "六月", "七月", "八月", "九月", "十月", "十一月", "十二月"]
+     *  - zh.SHORT: ["一", "二", "三", "四", "五", "六", "七", "八", "九", "十", "十一", "十二"]
+     *  - en.FULL: ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"]
+     *  - en.SHORT: ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"]
+     *
+     * QUARTER: 季度多语言配置
+     *  - zh.FULL: ["第一季度", "第二季度", "第三季度", "第四季度"]
+     *  - zh.SHORT: ["一季度", "二季度", "三季度", "四季度"]
+     *  - zh.MINI: ["一", "二", "三", "四"]
+     *  - en.FULL: ["quarter 1st", "quarter 2nd", "quarter 3rd", "quarter 4th"]
+     *  - en.SHORT: ["Q1th", "Q2nd", "Q3rd", "Q4th"]
+     *  - en.MINI: ["Q1", "Q2", "Q3", "Q4"]
+     *
+     * OVER_TIME: 剩余时间单位多语言配置
+     *  - zh: { YEAR: "年", MONTH: "月", DATE: "日", HOUR: "时", MINUTE: "分", SECOND: "秒", MILLISECOND: "毫秒", DAY: "天", QUARTER: "季度" }
+     *  - en: { YEAR: "year", MONTH: "month", DATE: "date", HOUR: "hour", MINUTE: "minute", SECOND: "second", MILLISECOND: "millisecond", DAY: "day", QUARTER: "quarter" }
+     *
+     * PASS_TIME: 过去时间描述多语言配置
+     *  - zh: { YEAR: "年前", MONTH: "个月前", DAY: "天前", BEFORE_YESTERDAY: "前天", YESTERDAY: "昨天", TODAY: "今天", HOUR: "小时前", MINUTE: "分钟前", JUST: "刚刚" }
+     *  - en: { YEAR: " year ago", MONTH: " month ago", DAY: " day ago", BEFORE_YESTERDAY: "before yesterday", YESTERDAY: " yesterday", TODAY: " today", HOUR: " hour ago", MINUTE: " minute ago", JUST: " just" }
+     *
+     * HOLIDAY: 节假日多语言配置
+     *  - zh: ["元旦", "春节", "清明节", "劳动节", "端午节", "中秋节", "国庆节"]
+     *  - en: ["New Year‘s Day", "Spring Festival", "Tomb Sweeping Day", "Labor Day", "Dragon Boat Festival", "Mid-Autumn Day", "National Day"]
+     *
+     * ZODIAC: 星座多语言配置
+     *  - zh: ["摩羯座", "水瓶座", "双鱼座", "白羊座", "金牛座", "双子座", "巨蟹座", "狮子座", "处女座", "天秤座", "天蝎座", "射手座"]
+     *  - en: ["Capricorn", "Aquarius", "Pisces", "Aries", "Taurus", "Gemini", "Cancer", "Leo", "Virgo", "Libra", "Scorpio", "Sagittarius"]
+     *
+     * CHINESE_ZODIAC: 生肖多语言配置
+     *  - zh: ["鼠", "牛", "虎", "兔", "龙", "蛇", "马", "羊", "猴", "鸡", "狗", "猪"]
+     *  - en: ["Rat", "Ox", "Tiger", "Rabbit", "Dragon", "Snake", "Horse", "Goat", "Monkey", "Rooster", "Dog", "Pig"]
+     *
+     * HEAVENLY_STEMS: 天干多语言配置
+     *  - zh: ["甲", "乙", "丙", "丁", "戊", "己", "庚", "辛", "壬", "癸"]
+     *  - en: ["Jia", "Yi", "Bing", "Ding", "Wu", "Ji", "Geng", "Xin", "Ren", "Gui"]
+     *
+     * EARTHLY_BRANCHES: 地支多语言配置
+     *  - zh: ["子", "丑", "寅", "卯", "辰", "巳", "午", "未", "申", "酉", "戌", "亥"]
+     *  - en: ["Zi", "Chou", "Yin", "Mao", "Chen", "Si", "Wu", "Wei", "Shen", "You", "Xu", "Hai"]
      */
     const DATE = {
         // 上午和下午
@@ -266,8 +366,123 @@
         },
     };
 
-    /*
-     * 键盘码
+    /**
+     * 键盘码相关常量配置（全局只读）
+     *
+     * 字符键：
+     *  - 8: Backspace
+     *  - 9: Tab
+     *  - 13: Enter
+     *  - 16: Shift
+     *  - 17: Ctrl
+     *  - 18: Alt
+     *  - 19: Pause
+     *  - 20: Caps Lock
+     *  - 27: Escape
+     *  - 32: Space
+     *  - 33: Page Up
+     *  - 34: Page Down
+     *  - 35: End
+     *  - 36: Home
+     *  - 37: Left
+     *  - 38: Up
+     *  - 39: Right
+     *  - 40: Down
+     *  - 42: Print Screen
+     *  - 45: Insert
+     *  - 46: Delete
+     *
+     * 数字键：
+     *  - 48: 0
+     *  - 49: 1
+     *  - 50: 2
+     *  - 51: 3
+     *  - 52: 4
+     *  - 53: 5
+     *  - 54: 6
+     *  - 55: 7
+     *  - 56: 8
+     *  - 57: 9
+     *
+     * 字母键：
+     *  - 65: A
+     *  - 66: B
+     *  - 67: C
+     *  - 68: D
+     *  - 69: E
+     *  - 70: F
+     *  - 71: G
+     *  - 72: H
+     *  - 73: I
+     *  - 74: J
+     *  - 75: K
+     *  - 76: L
+     *  - 77: M
+     *  - 78: N
+     *  - 79: O
+     *  - 80: P
+     *  - 81: Q
+     *  - 82: R
+     *  - 83: S
+     *  - 84: T
+     *  - 85: U
+     *  - 86: V
+     *  - 87: W
+     *  - 88: X
+     *  - 89: Y
+     *  - 90: Z
+     *
+     * window 相关键：
+     *  - 91: Windows
+     *  - 93: Right Click
+     *
+     * 数字小键盘（Numpad）：
+     *  - 96: Numpad 0
+     *  - 97: Numpad 1
+     *  - 98: Numpad 2
+     *  - 99: Numpad 3
+     *  - 100: Numpad 4
+     *  - 101: Numpad 5
+     *  - 102: Numpad 6
+     *  - 103: Numpad 7
+     *  - 104: Numpad 8
+     *  - 105: Numpad 9
+     *  - 106: Numpad *
+     *  - 107: Numpad +
+     *  - 109: Numpad -
+     *  - 110: Numpad .
+     *  - 111: Numpad /
+     *
+     * F功能键：
+     *  - 112: F1
+     *  - 113: F2
+     *  - 114: F3
+     *  - 115: F4
+     *  - 116: F5
+     *  - 117: F6
+     *  - 118: F7
+     *  - 119: F8
+     *  - 120: F9
+     *  - 121: F10
+     *  - 122: F11
+     *  - 123: F12
+     *
+     * 特殊符号/功能键：
+     *  - 144: Num Lock
+     *  - 145: Scroll Lock
+     *  - 182: My Computer
+     *  - 183: My Calculator
+     *  - 186: ;
+     *  - 187: =
+     *  - 188: ,
+     *  - 189: -
+     *  - 190: .
+     *  - 191: /
+     *  - 192: `
+     *  - 219: [
+     *  - 220: \
+     *  - 221: ]
+     *  - 222: '
      */
     const KEYCODE = {
         // 字符键
@@ -381,7 +596,48 @@
     };
 
     /**
-     * 身份证号
+     * 身份证号相关常量配置（全局只读）
+     *
+     * PROVINCE: 身份证号前两位对应的省份/地区编码映射
+     *  - 11: 北京
+     *  - 12: 天津
+     *  - 13: 河北
+     *  - 14: 山西
+     *  - 15: 内蒙古
+     *  - 21: 辽宁
+     *  - 22: 吉林
+     *  - 23: 黑龙江
+     *  - 31: 上海
+     *  - 32: 江苏
+     *  - 33: 浙江
+     *  - 34: 安徽
+     *  - 35: 福建
+     *  - 36: 江西
+     *  - 37: 山东
+     *  - 41: 河南
+     *  - 42: 湖北
+     *  - 43: 湖南
+     *  - 44: 广东
+     *  - 45: 广西
+     *  - 46: 海南
+     *  - 50: 重庆
+     *  - 51: 四川
+     *  - 52: 贵州
+     *  - 53: 云南
+     *  - 54: 西藏
+     *  - 61: 陕西
+     *  - 62: 甘肃
+     *  - 63: 青海
+     *  - 64: 宁夏
+     *  - 65: 新疆
+     *  - 71: 台湾
+     *  - 81: 香港
+     *  - 82: 澳门
+     *  - 91: 国外
+     *
+     * SEX: 身份证号解析的性别映射
+     *  - MAN: 男
+     *  - WOMAN: 女
      */
     const ID_CARD = {
         // 身份证号对应的省
@@ -3121,6 +3377,80 @@
         return date;
     }
     /* 格式化和解析日期 */
+    /**
+     * UTC 日期对象转本地时区日期对象
+     * @description 将 UTC 时间的 Date 对象转换为本地时间的 Date 对象（时间戳不变，仅调整时区偏移）
+     * @param {Date} date UTC 日期对象，默认当前 UTC 时间
+     * @returns {Date} 本地时区日期对象（时间戳 = UTC时间戳 + 时区偏移毫秒数）
+     * @example
+     * // UTC时间：2025-01-26 00:00:00
+     * const utcDate = new Date('2025-01-26T00:00:00Z');
+     * const localDate = fromDateUTC(utcDate);
+     * console.log(toDateString(localDate)); // 2025-01-26 08:00:00（北京本地时间）
+     */
+    function fromDateUTC(date = new Date()) {
+        return new Date(date.getTime() - date.getTimezoneOffset() * 60 * 1000);
+    }
+    /**
+     * 本地时区日期转 UTC 日期对象
+     * @description 将本地时间的 Date 对象转换为 UTC 时间的 Date 对象（时间戳不变，仅调整时区偏移）
+     * @param {Date} date 本地日期对象，默认当前本地时间
+     * @returns {Date} UTC 日期对象（时间戳 = 本地时间戳 - 时区偏移毫秒数）
+     * @example
+     * // 北京本地时间：2025-01-26 08:00:00（东8区）
+     * const localDate = new Date('2025-01-26 08:00:00');
+     * const utcDate = toDateUTC(localDate);
+     * console.log(utcDate.toISOString()); // 2025-01-26T00:00:00.000Z（UTC时间）
+     */
+    function toDateUTC(date = new Date()) {
+        return new Date(date.getTime() + date.getTimezoneOffset() * 60 * 1000);
+    }
+    /**
+     * 格式化日期为 UTC 字符串（符合 ISO 8601 标准）
+     * @description 直接输出 UTC 时间的字符串，无需手动转换时区
+     * @param {Date} date 本地日期对象，默认当前本地时间
+     * @param {DateOptions} options 格式化配置，默认 yyyy-MM-dd HH:mm:ss
+     * @returns {string} UTC 日期字符串
+     * @example
+     * const localDate = new Date('2025-01-26 08:00:00');
+     * console.log(toUTCString(localDate)); // 2025-01-26 00:00:00
+     */
+    function toDataUTCString(date = new Date(), options = { format: "yyyy-MM-dd HH:mm:ss" }) {
+        const utcDate = toDateUTC(date);
+        return toDateString(utcDate, options);
+    }
+    /**
+     * 日期字符串转为日期对象
+     * @description 支持日期字符串，时间戳，Unix时间戳
+     * @param {string|number} value 日期参数
+     * @returns {Date} 返回日期对象
+     */
+    function toDate(value) {
+        if (isNull(value))
+            return;
+        try {
+            // 是日期字符串
+            if (isString(value)) {
+                return new Date(String(value).replace(/-/g, "/"));
+            }
+            // 是时间戳
+            else if (isInteger(value) && String(value).length === 13) {
+                return new Date(value);
+            }
+            // 是unix时间戳
+            else if (isInteger(value) && String(value).length === 10) {
+                return new Date(Number(value) * 1000);
+            }
+            // 不支持的日期格式
+            else {
+                console.error("Not supported date format!");
+                return undefined;
+            }
+        }
+        catch (e) {
+            console.error("Parse to Date error", e);
+        }
+    }
     /**
      * 日期对象转为日期字符串
      * @description 支持日期字符串，日期对象，时间戳，unix时间戳
@@ -3223,46 +3553,6 @@
             return "";
         }
     }
-    /**
-     * 本地时区日期转UTC日期
-     * @param {Date} date 本地日期，默认当前日期
-     * @returns {Date} UTC日期对象
-     */
-    function toDateUTC(date = new Date()) {
-        return new Date(date.getTime() + date.getTimezoneOffset() * 60 * 1000);
-    }
-    /**
-     * 日期字符串转为日期对象
-     * @description 支持日期字符串，时间戳，Unix时间戳
-     * @param {string|number} value 日期参数
-     * @returns {Date} 返回日期对象
-     */
-    function toDate(value) {
-        if (isNull(value))
-            return;
-        try {
-            // 是日期字符串
-            if (isString(value)) {
-                return new Date(String(value).replace(/-/g, "/"));
-            }
-            // 是时间戳
-            else if (isInteger(value) && String(value).length === 13) {
-                return new Date(value);
-            }
-            // 是unix时间戳
-            else if (isInteger(value) && String(value).length === 10) {
-                return new Date(Number(value) * 1000);
-            }
-            // 不支持的日期格式
-            else {
-                console.error("Not supported date format!");
-                return undefined;
-            }
-        }
-        catch (e) {
-            console.error("Parse to Date error", e);
-        }
-    }
     /* 内部使用的函数 */
     /**
      * 单个数字前自动补齐零为两位
@@ -7833,6 +8123,7 @@
     exports.formatTemplate = formatTemplate;
     exports.formatThousand = formatThousand;
     exports.formatTitle = formatTitle;
+    exports.fromDateUTC = fromDateUTC;
     exports.gcd = gcd;
     exports.generateSM4Iv = generateSM4Iv;
     exports.generateSM4Key = generateSM4Key;
@@ -8067,6 +8358,7 @@
     exports.testLoaded = testLoaded;
     exports.throttle = throttle;
     exports.toCamelCase = toCamelCase;
+    exports.toDataUTCString = toDataUTCString;
     exports.toDate = toDate;
     exports.toDateString = toDateString;
     exports.toDateUTC = toDateUTC;