@sybz-components/utils 0.0.5 → 0.0.6

package/dist/day.d.cts

@@ -1 +1,81 @@
-export * from "/Users/liulihao/sybz/sybz-components/packages/utils/src/day";
+import { ConfigType, QUnitType, OpUnitType } from 'dayjs';
+
+type DayUnit = QUnitType | OpUnitType;
+/**
+ * 使用 `dayjs` 格式化日期。
+ *
+ * @param date 要格式化的日期值。为空时默认使用当前时间。
+ * @param format 输出格式，默认 `YYYY-MM-DD HH:mm:ss`。
+ * @returns 格式化后的日期字符串。
+ *
+ * @example
+ * formatDate('2026-04-24 12:30:45')
+ * // => '2026-04-24 12:30:45'
+ *
+ * @example
+ * formatDate('2026-04-24 12:30:45', 'YYYY/MM/DD')
+ * // => '2026/04/24'
+ */
+declare function formatDate(date?: ConfigType, format?: string): string;
+/**
+ * 将日期格式化为 `YYYY-MM-DD`。
+ *
+ * @param date 要格式化的日期值。
+ * @returns 形如 `2026-04-24` 的字符串。
+ *
+ * @example
+ * formatDateToDay(new Date())
+ *
+ * @example
+ * formatDateToDay('2026-04-24 12:30:45')
+ * // => '2026-04-24'
+ */
+declare const formatDateToDay: (date: ConfigType) => string;
+/**
+ * 将日期格式化为 `YYYY-MM-DD HH:mm`。
+ *
+ * @param date 要格式化的日期值。
+ * @returns 形如 `2026-04-24 12:30` 的字符串。
+ *
+ * @example
+ * formatDateToMinute(new Date())
+ *
+ * @example
+ * formatDateToMinute('2026-04-24 12:30:45')
+ * // => '2026-04-24 12:30'
+ */
+declare const formatDateToMinute: (date: ConfigType) => string;
+/**
+ * 计算两个日期之间的差值。
+ *
+ * @param date1 起始时间。未传时返回 `undefined`。
+ * @param date2 对比时间，默认取当前时间。
+ * @param format 差值单位，默认 `second`。
+ * @returns 两个时间的差值。
+ *
+ * @example
+ * diffDate('2026-04-24 12:00:00', '2026-04-24 11:59:00')
+ * // => 60
+ *
+ * @example
+ * diffDate('2026-04-24 12:00:00', '2026-04-24 11:30:00', 'minute')
+ * // => 30
+ */
+declare function diffDate(date1: ConfigType, date2?: ConfigType, format?: DayUnit): number | undefined;
+/**
+ * 将秒数转换成“几秒前 / 几分钟前 / 几小时前 / 几天前”这类相对时间文案。
+ *
+ * @param second 距离当前时间的秒数。
+ * @returns 中文相对时间描述。
+ *
+ * @example
+ * diffDateFromCurrent(45)
+ * // => '45秒前'
+ *
+ * @example
+ * diffDateFromCurrent(3600)
+ * // => '1小时前'
+ */
+declare function diffDateFromCurrent(second: number): string;
+
+export { diffDate, diffDateFromCurrent, formatDate, formatDateToDay, formatDateToMinute };

package/dist/day.d.mts

@@ -1 +1,81 @@
-export * from "/Users/liulihao/sybz/sybz-components/packages/utils/src/day";
+import { ConfigType, QUnitType, OpUnitType } from 'dayjs';
+
+type DayUnit = QUnitType | OpUnitType;
+/**
+ * 使用 `dayjs` 格式化日期。
+ *
+ * @param date 要格式化的日期值。为空时默认使用当前时间。
+ * @param format 输出格式，默认 `YYYY-MM-DD HH:mm:ss`。
+ * @returns 格式化后的日期字符串。
+ *
+ * @example
+ * formatDate('2026-04-24 12:30:45')
+ * // => '2026-04-24 12:30:45'
+ *
+ * @example
+ * formatDate('2026-04-24 12:30:45', 'YYYY/MM/DD')
+ * // => '2026/04/24'
+ */
+declare function formatDate(date?: ConfigType, format?: string): string;
+/**
+ * 将日期格式化为 `YYYY-MM-DD`。
+ *
+ * @param date 要格式化的日期值。
+ * @returns 形如 `2026-04-24` 的字符串。
+ *
+ * @example
+ * formatDateToDay(new Date())
+ *
+ * @example
+ * formatDateToDay('2026-04-24 12:30:45')
+ * // => '2026-04-24'
+ */
+declare const formatDateToDay: (date: ConfigType) => string;
+/**
+ * 将日期格式化为 `YYYY-MM-DD HH:mm`。
+ *
+ * @param date 要格式化的日期值。
+ * @returns 形如 `2026-04-24 12:30` 的字符串。
+ *
+ * @example
+ * formatDateToMinute(new Date())
+ *
+ * @example
+ * formatDateToMinute('2026-04-24 12:30:45')
+ * // => '2026-04-24 12:30'
+ */
+declare const formatDateToMinute: (date: ConfigType) => string;
+/**
+ * 计算两个日期之间的差值。
+ *
+ * @param date1 起始时间。未传时返回 `undefined`。
+ * @param date2 对比时间，默认取当前时间。
+ * @param format 差值单位，默认 `second`。
+ * @returns 两个时间的差值。
+ *
+ * @example
+ * diffDate('2026-04-24 12:00:00', '2026-04-24 11:59:00')
+ * // => 60
+ *
+ * @example
+ * diffDate('2026-04-24 12:00:00', '2026-04-24 11:30:00', 'minute')
+ * // => 30
+ */
+declare function diffDate(date1: ConfigType, date2?: ConfigType, format?: DayUnit): number | undefined;
+/**
+ * 将秒数转换成“几秒前 / 几分钟前 / 几小时前 / 几天前”这类相对时间文案。
+ *
+ * @param second 距离当前时间的秒数。
+ * @returns 中文相对时间描述。
+ *
+ * @example
+ * diffDateFromCurrent(45)
+ * // => '45秒前'
+ *
+ * @example
+ * diffDateFromCurrent(3600)
+ * // => '1小时前'
+ */
+declare function diffDateFromCurrent(second: number): string;
+
+export { diffDate, diffDateFromCurrent, formatDate, formatDateToDay, formatDateToMinute };

package/dist/day.d.ts

@@ -1 +1,81 @@
-export * from "/Users/liulihao/sybz/sybz-components/packages/utils/src/day";
+import { ConfigType, QUnitType, OpUnitType } from 'dayjs';
+
+type DayUnit = QUnitType | OpUnitType;
+/**
+ * 使用 `dayjs` 格式化日期。
+ *
+ * @param date 要格式化的日期值。为空时默认使用当前时间。
+ * @param format 输出格式，默认 `YYYY-MM-DD HH:mm:ss`。
+ * @returns 格式化后的日期字符串。
+ *
+ * @example
+ * formatDate('2026-04-24 12:30:45')
+ * // => '2026-04-24 12:30:45'
+ *
+ * @example
+ * formatDate('2026-04-24 12:30:45', 'YYYY/MM/DD')
+ * // => '2026/04/24'
+ */
+declare function formatDate(date?: ConfigType, format?: string): string;
+/**
+ * 将日期格式化为 `YYYY-MM-DD`。
+ *
+ * @param date 要格式化的日期值。
+ * @returns 形如 `2026-04-24` 的字符串。
+ *
+ * @example
+ * formatDateToDay(new Date())
+ *
+ * @example
+ * formatDateToDay('2026-04-24 12:30:45')
+ * // => '2026-04-24'
+ */
+declare const formatDateToDay: (date: ConfigType) => string;
+/**
+ * 将日期格式化为 `YYYY-MM-DD HH:mm`。
+ *
+ * @param date 要格式化的日期值。
+ * @returns 形如 `2026-04-24 12:30` 的字符串。
+ *
+ * @example
+ * formatDateToMinute(new Date())
+ *
+ * @example
+ * formatDateToMinute('2026-04-24 12:30:45')
+ * // => '2026-04-24 12:30'
+ */
+declare const formatDateToMinute: (date: ConfigType) => string;
+/**
+ * 计算两个日期之间的差值。
+ *
+ * @param date1 起始时间。未传时返回 `undefined`。
+ * @param date2 对比时间，默认取当前时间。
+ * @param format 差值单位，默认 `second`。
+ * @returns 两个时间的差值。
+ *
+ * @example
+ * diffDate('2026-04-24 12:00:00', '2026-04-24 11:59:00')
+ * // => 60
+ *
+ * @example
+ * diffDate('2026-04-24 12:00:00', '2026-04-24 11:30:00', 'minute')
+ * // => 30
+ */
+declare function diffDate(date1: ConfigType, date2?: ConfigType, format?: DayUnit): number | undefined;
+/**
+ * 将秒数转换成“几秒前 / 几分钟前 / 几小时前 / 几天前”这类相对时间文案。
+ *
+ * @param second 距离当前时间的秒数。
+ * @returns 中文相对时间描述。
+ *
+ * @example
+ * diffDateFromCurrent(45)
+ * // => '45秒前'
+ *
+ * @example
+ * diffDateFromCurrent(3600)
+ * // => '1小时前'
+ */
+declare function diffDateFromCurrent(second: number): string;
+
+export { diffDate, diffDateFromCurrent, formatDate, formatDateToDay, formatDateToMinute };

package/dist/day.mjs

@@ -1,24 +1,31 @@
-import { createJiti } from "../../../node_modules/.pnpm/jiti@2.5.1/node_modules/jiti/lib/jiti.mjs";
+import dayjs from 'dayjs';
 
-const jiti = createJiti(import.meta.url, {
-  "interopDefault": true,
-  "alias": {
-    "@sybz-components/utils": "/Users/liulihao/sybz/sybz-components/packages/utils"
-  },
-  "transformOptions": {
-    "babel": {
-      "plugins": []
-    }
+function formatDate(date, format = "YYYY-MM-DD HH:mm:ss") {
+  return dayjs(date || /* @__PURE__ */ new Date()).format(format);
+}
+const formatDateToDay = (date) => formatDate(date, "YYYY-MM-DD");
+const formatDateToMinute = (date) => formatDate(date, "YYYY-MM-DD HH:mm");
+function diffDate(date1, date2 = dayjs(), format = "second") {
+  if (!date1) return;
+  return dayjs(date1).diff(dayjs(date2), format);
+}
+function diffDateFromCurrent(second) {
+  if (second >= 60 * 60 * 24 * 365) {
+    return `${parseInt(String(second / (60 * 60 * 24 * 365)))}\u5E74\u524D`;
   }
-})
-
-/** @type {import("/Users/liulihao/sybz/sybz-components/packages/utils/src/day")} */
-const _module = await jiti.import("/Users/liulihao/sybz/sybz-components/packages/utils/src/day.ts");
+  if (second >= 60 * 60 * 24 * 30) {
+    return `${parseInt(String(second / (60 * 60 * 24 * 30)))}\u6708\u524D`;
+  }
+  if (second >= 60 * 60 * 24) {
+    return `${parseInt(String(second / (60 * 60 * 24)))}\u5929\u524D`;
+  }
+  if (second >= 60 * 60) {
+    return `${parseInt(String(second / (60 * 60)))}\u5C0F\u65F6\u524D`;
+  }
+  if (second >= 60) {
+    return `${parseInt(String(second / 60))}\u5206\u949F\u524D`;
+  }
+  return `${parseInt(String(second))}\u79D2\u524D`;
+}
 
-export const formatDate = _module.formatDate;
-export const format = _module.format;
-export const formatDateToDay = _module.formatDateToDay;
-export const formatDateToMinute = _module.formatDateToMinute;
-export const diffDate = _module.diffDate;
-export const date2 = _module.date2;
-export const diffDateFromCurrent = _module.diffDateFromCurrent;
+export { diffDate, diffDateFromCurrent, formatDate, formatDateToDay, formatDateToMinute };

package/dist/format.cjs

@@ -1,16 +1,19 @@
-const { createJiti } = require("../../../node_modules/.pnpm/jiti@2.5.1/node_modules/jiti/lib/jiti.cjs")
+'use strict';
 
-const jiti = createJiti(__filename, {
-  "interopDefault": true,
-  "alias": {
-    "@sybz-components/utils": "/Users/liulihao/sybz/sybz-components/packages/utils"
-  },
-  "transformOptions": {
-    "babel": {
-      "plugins": []
-    }
-  }
-})
+const format = require('./shared/utils.DrwfWQ1C.cjs');
+require('./is.cjs');
+require('@vue/reactivity');
+require('consola');
+require('es-toolkit');
+require('element-plus');
 
-/** @type {import("/Users/liulihao/sybz/sybz-components/packages/utils/src/format")} */
-module.exports = jiti("/Users/liulihao/sybz/sybz-components/packages/utils/src/format.ts")
+
+
+exports.formatBytes = format.formatBytes;
+exports.formatBytesConvert = format.formatBytesConvert;
+exports.formatDurationTime = format.formatDurationTime;
+exports.formatImg = format.formatImg;
+exports.formatTextToHtml = format.formatTextToHtml;
+exports.formatThousands = format.formatThousands;
+exports.formatTime = format.formatTime;
+exports.formatToFixed = format.formatToFixed;

package/dist/format.d.cts

@@ -1 +1,208 @@
-export * from "/Users/liulihao/sybz/sybz-components/packages/utils/src/format";
+/**
+ * `formatBytes` 的配置项。
+ */
+interface FormatBytesOptions {
+    /**
+     * 小数位数，默认 `2`。
+     */
+    digit?: number;
+    /**
+     * 是否加千分位，默认 `false`。
+     */
+    thousands?: boolean;
+    /**
+     * 文本前缀，例如 `$`。
+     */
+    prefix?: string;
+    /**
+     * 文本后缀，例如 `/s`。
+     */
+    suffix?: string;
+    /**
+     * 取整方式，默认 `floor`。
+     */
+    roundType?: 'floor' | 'ceil' | 'round';
+}
+/**
+ * `formatBytesConvert` 的配置项。
+ */
+interface FormatBytesConvertOptions {
+    /**
+     * 是否使用千分位输出。
+     */
+    thounsands?: boolean;
+    /**
+     * 保留小数位数。
+     */
+    digit?: number;
+}
+/**
+ * `formatImg` 的配置项。
+ */
+interface FormatImgOptions {
+    /**
+     * 静态资源根目录，默认 `assets/images`。
+     */
+    basePath?: string;
+}
+/**
+ * `formatToFixed` 的配置项。
+ */
+interface FormatToFixedOptions {
+    /**
+     * 小数位数，默认 `2`。
+     */
+    digit?: number;
+    /**
+     * 文本前缀，例如 `$`。
+     */
+    prefix?: string;
+    /**
+     * 文本后缀，例如 `%`。
+     */
+    suffix?: string;
+    /**
+     * 是否保留原单位，默认 `true`。
+     */
+    unit?: boolean;
+    /**
+     * 是否添加千分位，默认 `false`。
+     */
+    thousands?: boolean;
+}
+type FormatTimeInput = Date | string | number;
+type FormatTimeFallback = string | ((time: FormatTimeInput) => string);
+/**
+ * 将字节数格式化成更易读的单位字符串。
+ *
+ * @param bytes 字节数，支持数字和数字字符串。
+ * @param options 配置项。
+ * @returns 格式化后的字节字符串；如果输入不是合法数字，则原样返回。
+ *
+ * @example
+ * formatBytes(1024)
+ * // => '1.00 KB'
+ *
+ * @example
+ * formatBytes(1040000, {
+ *   digit: 3,
+ *   prefix: '$',
+ *   suffix: '/s',
+ *   roundType: 'round',
+ *   thousands: true,
+ * })
+ * // => '$1,015.625 KB/s'
+ */
+declare function formatBytes(bytes: number | string, options?: FormatBytesOptions): string | number;
+/**
+ * 将带单位的字节字符串转换为原始字节数。
+ *
+ * @param oBytes 字节字符串，例如 `1.5GB`、`1,024 KB`，也支持纯数字。
+ * @param options 配置项。
+ * @returns 字节数；如启用了 `digit` 或 `thounsands`，返回格式化后的字符串。
+ *
+ * @example
+ * formatBytesConvert('0.5GB')
+ * // => 536870912
+ *
+ * @example
+ * formatBytesConvert('1,234 GB', { thounsands: true })
+ * // => '1,324,997,410,816'
+ */
+declare function formatBytesConvert(oBytes: unknown, options?: FormatBytesConvertOptions): string | number | undefined;
+/**
+ * 为数字或数字字符串添加千分位分隔符。
+ *
+ * @param value 需要格式化的值。
+ * @returns 添加千分位后的字符串；如果不符合规则则原样返回。
+ *
+ * @example
+ * formatThousands(1234567)
+ * // => '1,234,567'
+ *
+ * @example
+ * formatThousands('1234.12MB')
+ * // => '1,234.12MB'
+ */
+declare function formatThousands(value: string | number): string | number;
+/**
+ * 将时间值格式化为指定模板字符串。
+ *
+ * 支持 `Date`、毫秒时间戳、秒级时间戳、ISO 字符串和普通日期字符串。
+ * 纯日期字符串（如 `2022-03-04`）会按本地时区的 `00:00:00` 解析。
+ *
+ * @param time 时间值，默认当前时间。
+ * @param cFormat 格式模板，默认 `{y}-{m}-{d} {h}:{i}:{s}`。
+ * @param fallback 非法日期时的兜底返回值，默认返回原始输入。
+ * @returns 格式化后的时间字符串。
+ *
+ * @example
+ * formatTime(new Date(), '{y}-{m}-{d} {h}:{i}:{s}')
+ *
+ * @example
+ * formatTime(1713926400, '{y}/{m}/{d}')
+ * // => '2024/04/24'
+ */
+declare function formatTime(time?: FormatTimeInput, cFormat?: string, fallback?: FormatTimeFallback): string;
+/**
+ * 将持续时间时间戳格式化为“天 / 时 / 分 / 秒”文本。
+ *
+ * @param timestamp 持续时间，单位毫秒。
+ * @param cFormat 输出模板，默认 `{d}天{h}时{i}分{s}秒`。
+ * @returns 格式化后的持续时间文本。
+ *
+ * @example
+ * formatDurationTime(1162821)
+ * // => '19分24秒'
+ *
+ * @example
+ * formatDurationTime(5 * 60 * 1000, '{i}分{s}秒')
+ * // => '05分00秒'
+ */
+declare function formatDurationTime(timestamp: number, cFormat?: string): string;
+/**
+ * 获取 `assets` 目录下的静态资源地址。
+ *
+ * @param photoName 文件名；未带后缀时会自动补 `.png`。
+ * @param addPath 额外子目录，例如 `menu`。
+ * @param options 配置项。
+ * @returns 静态资源的完整 URL；如果本身已是 `http/https` 地址，则原样返回。
+ *
+ * @example
+ * formatImg('logo')
+ *
+ * @example
+ * formatImg('avatar.png', 'user')
+ */
+declare function formatImg(photoName: string, addPath?: string, { basePath }?: FormatImgOptions): string;
+/**
+ * 按指定小数位格式化数字，并可附带前后缀、单位和千分位。
+ *
+ * @param value 需要格式化的值。
+ * @param options 小数位数或配置项。
+ * @returns 格式化后的字符串。
+ *
+ * @example
+ * formatToFixed('22.1', 2)
+ * // => '22.10'
+ *
+ * @example
+ * formatToFixed('22 TB', { digit: 2, unit: false, prefix: '$' })
+ * // => '$22.00'
+ */
+declare function formatToFixed(value: unknown, options?: FormatToFixedOptions | number): string;
+/**
+ * 将纯文本中的换行和制表符转换成可直接渲染的 HTML 片段。
+ *
+ * @param str 需要格式化的文本。
+ * @returns 字符串输入会返回转换后的 HTML；非字符串输入会原样返回。
+ *
+ * @example
+ * formatTextToHtml('第1行\n\t第2行')
+ * // => '第1行<br>&nbsp;&nbsp;&nbsp;&nbsp;第2行'
+ */
+declare function formatTextToHtml(str: string): string;
+declare function formatTextToHtml<T>(str: T): T;
+
+export { formatBytes, formatBytesConvert, formatDurationTime, formatImg, formatTextToHtml, formatThousands, formatTime, formatToFixed };
+export type { FormatBytesConvertOptions, FormatBytesOptions, FormatImgOptions, FormatTimeFallback, FormatTimeInput, FormatToFixedOptions };