@allahjs/utils 0.0.1

package/dist/core/dateUtils/index.cjs

@@ -0,0 +1,245 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var dayjs = require('dayjs');
+
+/**
+ * 日期工具函数
+ */
+/**
+ * 日期工具对象
+ */
+const dateUtils = {
+    /**
+     * 格式化日期
+     * @param date 日期对象或时间戳
+     * @param format 格式字符串，如 'YYYY-MM-DD HH:mm:ss'
+     * @returns 格式化后的日期字符串
+     */
+    formatDate(date, format = 'YYYY-MM-DD HH:mm:ss') {
+        if (!date)
+            return '未知';
+        return dayjs(date).format(format);
+    },
+    /**
+     * 获取相对时间描述
+     * @param date 日期对象或时间戳
+     * @returns 相对时间描述，如 '2小时前'
+     */
+    timeAgo(date) {
+        const now = dayjs();
+        const target = dayjs(date);
+        const diff = now.diff(target);
+        const minute = 60 * 1000;
+        const hour = minute * 60;
+        const day = hour * 24;
+        const month = day * 30;
+        const year = day * 365;
+        if (diff < minute) {
+            return '刚刚';
+        }
+        else if (diff < hour) {
+            return `${Math.floor(diff / minute)}分钟前`;
+        }
+        else if (diff < day) {
+            return `${Math.floor(diff / hour)}小时前`;
+        }
+        else if (diff < month) {
+            return `${Math.floor(diff / day)}天前`;
+        }
+        else if (diff < year) {
+            return `${Math.floor(diff / month)}个月前`;
+        }
+        return `${Math.floor(diff / year)}年前`;
+    },
+    /**
+     * 添加时间
+     * @param date 日期对象或时间戳
+     * @param amount 数量
+     * @param unit 单位：'years' | 'months' | 'days' | 'hours' | 'minutes' | 'seconds'
+     * @returns 新的日期对象
+     */
+    addTime(date, amount, unit) {
+        const unitMap = {
+            years: 'year',
+            months: 'month',
+            days: 'day',
+            hours: 'hour',
+            minutes: 'minute',
+            seconds: 'second'
+        };
+        return dayjs(date).add(amount, unitMap[unit]).toDate();
+    },
+    /**
+     * 获取日期范围的开始和结束
+     * @param date 日期对象或时间戳
+     * @param unit 单位：'day' | 'week' | 'month' | 'year'
+     * @returns 包含开始和结束日期的对象
+     */
+    getDateRange(date, unit) {
+        const d = dayjs(date);
+        const start = d.startOf(unit).toDate();
+        const end = d.endOf(unit).add(1, 'millisecond').toDate();
+        return { start, end };
+    },
+    /**
+     * 判断是否为同一天
+     * @param date1 日期1
+     * @param date2 日期2
+     * @returns 是否为同一天
+     */
+    isSameDay(date1, date2) {
+        return dayjs(date1).isSame(dayjs(date2), 'day');
+    },
+    /**
+     * 判断是否为闰年
+     * @param year 年份
+     * @returns 是否为闰年
+     */
+    isLeapYear(year) {
+        return (year % 4 === 0 && year % 100 !== 0) || (year % 400 === 0);
+    },
+    /**
+     * 获取月份天数
+     * @param year 年份
+     * @param month 月份（0-11）
+     * @returns 天数
+     */
+    getDaysInMonth(year, month) {
+        return dayjs().year(year).month(month).daysInMonth();
+    },
+    /**
+     * 获取最近几年的年份选项
+     * @param num 几年？默认三年（向上取）
+     * @returns 年份选项数组
+     */
+    getYearOptions(num = 3) {
+        const yearList = [];
+        const currentYear = dayjs().year();
+        for (let i = 0; i < num; i += 1) {
+            const year = currentYear + i;
+            yearList.push({
+                id: year,
+                text: year
+            });
+        }
+        return yearList;
+    },
+    /**
+     * 获取最近几年的年份选项（向下取）
+     * @param num 几年？默认三年（向下取）
+     * @returns 年份选项数组
+     */
+    getPastYearOptions(num = 3) {
+        const yearList = [];
+        const currentYear = dayjs().year();
+        for (let i = 0; i < num; i += 1) {
+            const year = currentYear - i;
+            yearList.push({
+                id: year,
+                text: year
+            });
+        }
+        return yearList;
+    },
+    /**
+     * 格式化时间显示
+     * @param timestamp 时间戳（字符串或数字）
+     * @returns 格式化后的时间显示字符串
+     */
+    formatTime(timestamp) {
+        const date = dayjs(timestamp);
+        const now = dayjs();
+        const diff = now.diff(date);
+        // 小于1分钟
+        if (diff < 60 * 1000) {
+            return '刚刚';
+        }
+        // 小于1小时
+        if (diff < 60 * 60 * 1000) {
+            return `${Math.floor(diff / (60 * 1000))}分钟前`;
+        }
+        // 小于1天
+        if (diff < 24 * 60 * 60 * 1000) {
+            return `${Math.floor(diff / (60 * 60 * 1000))}小时前`;
+        }
+        // 小于7天
+        if (diff < 7 * 24 * 60 * 60 * 1000) {
+            return `${Math.floor(diff / (24 * 60 * 60 * 1000))}天前`;
+        }
+        // 超过7天显示具体日期
+        return date.format('M月D日 HH:mm');
+    },
+    /**
+     * 根据当前的时间，来生成是凌晨、早上、中午、下午、晚上，返回对应的字符串
+     */
+    getDayTimeStr: (date = dayjs()) => {
+        const hour = date.hour();
+        if (hour >= 0 && hour < 6) {
+            return '凌晨';
+        }
+        else if (hour >= 6 && hour < 12) {
+            return '上午';
+        }
+        else if (hour >= 12 && hour < 14) {
+            return '中午';
+        }
+        else if (hour >= 14 && hour < 18) {
+            return '下午';
+        }
+        else if (hour >= 18 && hour < 24) {
+            return '晚上';
+        }
+        return '';
+    },
+    /**
+     * 安全格式化日期
+     *
+     * @param date - 要格式化的日期，可以是字符串、数字、Date 对象或 dayjs 对象
+     * @param format - 输出的日期格式，默认为 "YYYY-MM-DD"
+     * @returns 格式化后的日期字符串；如果输入无效，则返回 "-"
+     *
+     * @example
+     * safeFormat("2025-09-20") // "2025-09-20"
+     * safeFormat("2025-13-40") // "-"
+     * safeFormat(new Date(), "YYYY/MM/DD HH:mm") // "2025/09/20 16:30"
+     */
+    safeFormat: (date, format = 'YYYY-MM-DD') => {
+        if (date === null || date === undefined || date === '') {
+            return '-';
+        }
+        const d = dayjs(date);
+        return d.isValid() ? d.format(format) : '-';
+    },
+    /**
+     * 安全格式化时间
+     */
+    safeFormatTime: (date, format = 'YYYY-MM-DD HH:mm:ss') => {
+        return dateUtils.safeFormat(date, format);
+    },
+    /**
+     * 格式化日期范围显示
+     * 将开始时间和结束时间格式化为范围显示
+     * @param startTime 开始时间
+     * @param endTime 结束时间
+     * @returns 格式化后的日期范围字符串
+     */
+    formatDateRange: (startTime, endTime) => {
+        const start = dateUtils.safeFormat(startTime);
+        const end = dateUtils.safeFormat(endTime);
+        if (start === '-' && end === '-') {
+            return '-';
+        }
+        else if (start === '-') {
+            return `至 ${end}`;
+        }
+        else if (end === '-') {
+            return `${start} 至 -`;
+        }
+        return `${start} - ${end}`;
+    }
+};
+
+exports.default = dateUtils;
+//# sourceMappingURL=index.cjs.map

package/dist/core/dateUtils/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../src/core/dateUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/core/dateUtils/index.d.ts

@@ -0,0 +1,117 @@
+import { Dayjs } from 'dayjs';
+
+/**
+ * 日期工具函数
+ */
+
+/**
+ * 日期工具对象
+ */
+declare const dateUtils: {
+    /**
+     * 格式化日期
+     * @param date 日期对象或时间戳
+     * @param format 格式字符串，如 'YYYY-MM-DD HH:mm:ss'
+     * @returns 格式化后的日期字符串
+     */
+    formatDate(date: Date | number | string, format?: string): string;
+    /**
+     * 获取相对时间描述
+     * @param date 日期对象或时间戳
+     * @returns 相对时间描述，如 '2小时前'
+     */
+    timeAgo(date: Date | number | string): string;
+    /**
+     * 添加时间
+     * @param date 日期对象或时间戳
+     * @param amount 数量
+     * @param unit 单位：'years' | 'months' | 'days' | 'hours' | 'minutes' | 'seconds'
+     * @returns 新的日期对象
+     */
+    addTime(date: Date | number | string, amount: number, unit: "years" | "months" | "days" | "hours" | "minutes" | "seconds"): Date;
+    /**
+     * 获取日期范围的开始和结束
+     * @param date 日期对象或时间戳
+     * @param unit 单位：'day' | 'week' | 'month' | 'year'
+     * @returns 包含开始和结束日期的对象
+     */
+    getDateRange(date: Date | number | string, unit: "day" | "week" | "month" | "year"): {
+        start: Date;
+        end: Date;
+    };
+    /**
+     * 判断是否为同一天
+     * @param date1 日期1
+     * @param date2 日期2
+     * @returns 是否为同一天
+     */
+    isSameDay(date1: Date | number | string, date2: Date | number | string): boolean;
+    /**
+     * 判断是否为闰年
+     * @param year 年份
+     * @returns 是否为闰年
+     */
+    isLeapYear(year: number): boolean;
+    /**
+     * 获取月份天数
+     * @param year 年份
+     * @param month 月份（0-11）
+     * @returns 天数
+     */
+    getDaysInMonth(year: number, month: number): number;
+    /**
+     * 获取最近几年的年份选项
+     * @param num 几年？默认三年（向上取）
+     * @returns 年份选项数组
+     */
+    getYearOptions(num?: number): Array<{
+        id: number;
+        text: number;
+    }>;
+    /**
+     * 获取最近几年的年份选项（向下取）
+     * @param num 几年？默认三年（向下取）
+     * @returns 年份选项数组
+     */
+    getPastYearOptions(num?: number): Array<{
+        id: number;
+        text: number;
+    }>;
+    /**
+     * 格式化时间显示
+     * @param timestamp 时间戳（字符串或数字）
+     * @returns 格式化后的时间显示字符串
+     */
+    formatTime(timestamp: string | number): string;
+    /**
+     * 根据当前的时间，来生成是凌晨、早上、中午、下午、晚上，返回对应的字符串
+     */
+    getDayTimeStr: (date?: Dayjs) => "" | "凌晨" | "上午" | "中午" | "下午" | "晚上";
+    /**
+     * 安全格式化日期
+     *
+     * @param date - 要格式化的日期，可以是字符串、数字、Date 对象或 dayjs 对象
+     * @param format - 输出的日期格式，默认为 "YYYY-MM-DD"
+     * @returns 格式化后的日期字符串；如果输入无效，则返回 "-"
+     *
+     * @example
+     * safeFormat("2025-09-20") // "2025-09-20"
+     * safeFormat("2025-13-40") // "-"
+     * safeFormat(new Date(), "YYYY/MM/DD HH:mm") // "2025/09/20 16:30"
+     */
+    safeFormat: (date: any, format?: string) => string;
+    /**
+     * 安全格式化时间
+     */
+    safeFormatTime: (date: any, format?: string) => string;
+    /**
+     * 格式化日期范围显示
+     * 将开始时间和结束时间格式化为范围显示
+     * @param startTime 开始时间
+     * @param endTime 结束时间
+     * @returns 格式化后的日期范围字符串
+     */
+    formatDateRange: (startTime?: string, endTime?: string) => string;
+};
+
+export { dateUtils as default };

package/dist/core/index.cjs

@@ -0,0 +1,34 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var index$8 = require('./arrayUtils/index.cjs');
+var index$7 = require('./stringUtils/index.cjs');
+var index$6 = require('./objectUtils/index.cjs');
+var index$5 = require('./numberUtils/index.cjs');
+var index$3 = require('./colorUtils/index.cjs');
+var index$4 = require('./dateUtils/index.cjs');
+var index$1 = require('./asyncUtils/index.cjs');
+var index$2 = require('./validationUtils/index.cjs');
+
+/**
+ * 核心工具函数库
+ * 统一导出所有工具对象
+ */
+/**
+ * 默认导出所有工具对象的集合
+ */
+var index = {
+    arrayUtils: index$8.default,
+    stringUtils: index$7.default,
+    objectUtils: index$6.default,
+    numberUtils: index$5.default,
+    dateUtils: index$4.default,
+    asyncUtils: index$1.default,
+    colorUtils: index$3.default,
+    validationUtils: index$2.default,
+    AsyncQueue: index$1.AsyncQueue
+};
+
+exports.default = index;
+//# sourceMappingURL=index.cjs.map

package/dist/core/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../src/core/index.ts"],"sourcesContent":[null],"names":["arrayUtils","stringUtils","objectUtils","numberUtils","dateUtils","asyncUtils","colorUtils","validationUtils","AsyncQueue"],"mappings":";;;;;;;;;;;;;AAAA;;;AAGG;AAWH;;AAEG;AACH,YAAe;gBACbA,eAAU;iBACVC,eAAW;iBACXC,eAAW;iBACXC,eAAW;eACXC,eAAS;gBACTC,eAAU;gBACVC,eAAU;qBACVC,eAAe;gBACfC;CACD;;;;"}

package/dist/core/index.d.ts

@@ -0,0 +1,118 @@
+import * as dayjs from 'dayjs';
+import { IOptions2 } from '../types/data/index.js';
+import { AsyncQueue } from './asyncUtils/index.js';
+
+/**
+ * 默认导出所有工具对象的集合
+ */
+declare const _default: {
+    arrayUtils: {
+        unique<T>(arr: T[]): T[];
+        chunk<T>(arr: T[], size: number): T[][];
+        flatten<T>(arr: any[], depth?: number): T[];
+        shuffle<T>(arr: T[]): T[];
+        intersection<T>(arr1: T[], arr2: T[]): T[];
+        difference<T>(arr1: T[], arr2: T[]): T[];
+        groupBy<T, K extends string | number | symbol>(arr: T[], keyFn: (item: T) => K): Record<K, T[]>;
+        getListId(s: string, optList: IOptions2[], key: string): any;
+    };
+    stringUtils: {
+        capitalize(str: string): string;
+        toCamelCase(str: string): string;
+        toKebabCase(str: string): string;
+        toSnakeCase(str: string): string;
+        truncate(str: string, length: number, suffix?: string): string;
+        trim(str: string): string;
+        randomString(length: number, chars?: string): string;
+        buildMoneyStr(str: number | string): string;
+        replaceEmpty: (data: any, replaceStr?: string) => any;
+        replaceFieldsEmpty: (data: any, fields: string[], replaceStr?: string) => any;
+    };
+    objectUtils: {
+        deepClone<T>(obj: T): T;
+        merge<T extends Record<string, any>>(target: T, ...sources: Partial<T>[]): T;
+        get<T = any>(obj: Record<string, any>, path: string, defaultValue?: T): T;
+        set(obj: Record<string, any>, path: string, value: any): void;
+        unset(obj: Record<string, any>, path: string): boolean;
+        paths(obj: Record<string, any>, prefix?: string): string[];
+        buildNullStr<T = any>(obj: any, str?: string): T;
+        objToNum(obj: any): any;
+        refreshState(state: any, payload: any): void;
+        deleteTime(obj: any, keys?: string[]): any;
+        enumToOptions(enumObj: any): any[];
+        isSameObj(obj1: any, obj2: any): boolean;
+    };
+    numberUtils: {
+        formatNumber(num: number, separator?: string): string;
+        toFixed(num: number, digits: number): number;
+        random(min: number, max: number, integer?: boolean): number;
+        clamp(num: number, min: number, max: number): number;
+        mapRange(value: number, fromMin: number, fromMax: number, toMin: number, toMax: number): number;
+        isEven(num: number): boolean;
+        isOdd(num: number): boolean;
+        percentage(value: number, total: number, digits?: number): number;
+        formatBytes(bytes: number, digits?: number): string;
+        gcd(a: number, b: number): number;
+        lcm(a: number, b: number): number;
+    };
+    dateUtils: {
+        formatDate(date: Date | number | string, format?: string): string;
+        timeAgo(date: Date | number | string): string;
+        addTime(date: Date | number | string, amount: number, unit: "years" | "months" | "days" | "hours" | "minutes" | "seconds"): Date;
+        getDateRange(date: Date | number | string, unit: "day" | "week" | "month" | "year"): {
+            start: Date;
+            end: Date;
+        };
+        isSameDay(date1: Date | number | string, date2: Date | number | string): boolean;
+        isLeapYear(year: number): boolean;
+        getDaysInMonth(year: number, month: number): number;
+        getYearOptions(num?: number): Array<{
+            id: number;
+            text: number;
+        }>;
+        getPastYearOptions(num?: number): Array<{
+            id: number;
+            text: number;
+        }>;
+        formatTime(timestamp: string | number): string;
+        getDayTimeStr: (date?: dayjs.Dayjs) => "" | "凌晨" | "上午" | "中午" | "下午" | "晚上";
+        safeFormat: (date: any, format?: string) => string;
+        safeFormatTime: (date: any, format?: string) => string;
+        formatDateRange: (startTime?: string, endTime?: string) => string;
+    };
+    asyncUtils: {
+        delay(ms: number): Promise<void>;
+        withTimeout<T>(promise: Promise<T>, timeout: number, timeoutMessage?: string): Promise<T>;
+        retry<T>(fn: () => Promise<T>, maxRetries?: number, delayMs?: number): Promise<T>;
+        concurrent<T>(tasks: (() => Promise<T>)[], concurrency?: number): Promise<T[]>;
+        debounce<T extends (...args: any[]) => any>(fn: T, delay: number): (...args: Parameters<T>) => void;
+        throttle<T extends (...args: any[]) => any>(fn: T, interval: number): (...args: Parameters<T>) => void;
+        createQueue(): AsyncQueue;
+        memoizeAsync<T extends (...args: any[]) => Promise<any>>(fn: T, keyFn?: (...args: Parameters<T>) => string, ttl?: number): T;
+    };
+    colorUtils: {
+        getColor(index: number): string;
+    };
+    validationUtils: {
+        isEmail(email: string): boolean;
+        isPhone(phone: string): boolean;
+        isIdCard(idCard: string): boolean;
+        isUrl(url: string): boolean;
+        isIp(ip: string): boolean;
+        passwordStrength(password: string, options?: {
+            minLength?: number;
+            requireUppercase?: boolean;
+            requireLowercase?: boolean;
+            requireNumbers?: boolean;
+            requireSpecialChars?: boolean;
+        }): number;
+        isBankCard(cardNumber: string): boolean;
+        hasChinese(text: string): boolean;
+        isChineseOnly(text: string): boolean;
+        isInRange(value: number, min: number, max: number): boolean;
+        isLengthInRange(str: string, min: number, max: number): boolean;
+    };
+    AsyncQueue: typeof AsyncQueue;
+};
+
+export { _default as default };

package/dist/core/numberUtils/index.cjs

@@ -0,0 +1,126 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * 数字工具函数
+ */
+/**
+ * 数字工具对象
+ */
+const numberUtils = {
+    /**
+     * 格式化数字（添加千分位分隔符）
+     * @param num 数字
+     * @param separator 分隔符，默认为 ','
+     * @returns 格式化后的字符串
+     */
+    formatNumber(num, separator = ',') {
+        return num.toString().replace(/\B(?=(\d{3})+(?!\d))/g, separator);
+    },
+    /**
+     * 保留指定小数位数
+     * @param num 数字
+     * @param digits 小数位数
+     * @returns 处理后的数字
+     */
+    toFixed(num, digits) {
+        return Number(num.toFixed(digits));
+    },
+    /**
+     * 生成指定范围内的随机数
+     * @param min 最小值
+     * @param max 最大值
+     * @param integer 是否为整数，默认为 false
+     * @returns 随机数
+     */
+    random(min, max, integer = false) {
+        const result = Math.random() * (max - min) + min;
+        return integer ? Math.floor(result) : result;
+    },
+    /**
+     * 限制数字在指定范围内
+     * @param num 数字
+     * @param min 最小值
+     * @param max 最大值
+     * @returns 限制后的数字
+     */
+    clamp(num, min, max) {
+        return Math.min(Math.max(num, min), max);
+    },
+    /**
+     * 数字映射到新范围
+     * @param value 原值
+     * @param fromMin 原范围最小值
+     * @param fromMax 原范围最大值
+     * @param toMin 新范围最小值
+     * @param toMax 新范围最大值
+     * @returns 映射后的值
+     */
+    mapRange(value, fromMin, fromMax, toMin, toMax) {
+        return ((value - fromMin) * (toMax - toMin)) / (fromMax - fromMin) + toMin;
+    },
+    /**
+     * 判断是否为偶数
+     * @param num 数字
+     * @returns 是否为偶数
+     */
+    isEven(num) {
+        return num % 2 === 0;
+    },
+    /**
+     * 判断是否为奇数
+     * @param num 数字
+     * @returns 是否为奇数
+     */
+    isOdd(num) {
+        return num % 2 !== 0;
+    },
+    /**
+     * 计算百分比
+     * @param value 值
+     * @param total 总数
+     * @param digits 小数位数，默认为 2
+     * @returns 百分比
+     */
+    percentage(value, total, digits = 2) {
+        if (total === 0)
+            return 0;
+        return numberUtils.toFixed((value / total) * 100, digits);
+    },
+    /**
+     * 数字转换为文件大小格式
+     * @param bytes 字节数
+     * @param digits 小数位数，默认为 2
+     * @returns 文件大小字符串
+     */
+    formatBytes(bytes, digits = 2) {
+        if (bytes === 0)
+            return '0 Bytes';
+        const k = 1024;
+        const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB', 'PB'];
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return `${numberUtils.toFixed(bytes / Math.pow(k, i), digits)} ${sizes[i]}`;
+    },
+    /**
+     * 求最大公约数
+     * @param a 数字a
+     * @param b 数字b
+     * @returns 最大公约数
+     */
+    gcd(a, b) {
+        return b === 0 ? a : numberUtils.gcd(b, a % b);
+    },
+    /**
+     * 求最小公倍数
+     * @param a 数字a
+     * @param b 数字b
+     * @returns 最小公倍数
+     */
+    lcm(a, b) {
+        return Math.abs(a * b) / numberUtils.gcd(a, b);
+    }
+};
+
+exports.default = numberUtils;
+//# sourceMappingURL=index.cjs.map

package/dist/core/numberUtils/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../src/core/numberUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}