@planarcat/js-toolkit 1.5.5 → 1.6.0

package/README.md

@@ -248,6 +248,30 @@ npm run test:coverage
 
 ## 更新日志
 
+### v1.6.0
+
+- ✨ 增强了日期格式化功能，支持更多格式化标记
+- ✨ 新增月份相关标记：`MMMM`（完整月份名称）、`MMM`（月份缩写）
+- ✨ 新增日期相关标记：`DDD`（一年中的第几天）、`Do`（带序数词的日期）
+- ✨ 新增时间相关标记：`S`（单个毫秒）
+- ✨ 新增星期相关标记：`dddd`（完整星期名称）、`ddd`（星期缩写）
+- ✨ 新增时间戳相关标记：`X`（Unix时间戳秒）、`x`（Unix时间戳毫秒）
+- ✨ 优化了文档结构，添加了完整的格式化标记参考
+- ✨ 完善了测试用例，覆盖所有新功能
+
+### v1.5.6
+
+- ✨ 优化了 `toFormattedNumberString` 函数的内部实现，将内部函数提取到外部
+- ✨ 统一了变量命名规范，根据转化进度命名：converted、preProcessed、formatted
+- ✨ 新增测试用例，验证预处理函数和后缀函数的组合使用
+- ✨ 提高了代码的可读性和可维护性
+
+### v1.5.5
+
+- ✨ 修复了测试文件中的未使用变量警告
+- ✨ 优化了代码注释，删除了重复的不必要说明
+- ✨ 提高了代码的简洁性和可维护性
+
 ### v1.5.3
 
 - ✨ 增强了 `toFormattedNumberString` 函数，为 `preProcessor`、`prefix` 和 `suffix` 函数更新了参数顺序

package/dist/date/formatDate.d.ts

@@ -1,4 +1,4 @@
-import { DateInput, DateFormatOptions } from "../types/date";
+import { DateFormatOptions, DateInput } from '../types/date';
 /**
  * 格式化日期对象
  *
@@ -18,23 +18,53 @@ import { DateInput, DateFormatOptions } from "../types/date";
  * // 自定义格式
  * formatDate('2023-12-25', 'YYYY年MM月DD日');
  * // 返回: "2023年12月25日"
- *
- * // 使用 dd 标记显示周几
- * formatDate(new Date(), 'dd HH:mm');
- * // 返回: "周一 14:30"
- *
- * // 英文环境显示周几
- * formatDate(new Date(), 'dd HH:mm', { locale: 'en-US' });
- * // 返回: "Monday 14:30"
- *
- * // 自定义格式化器
- * formatDate(new Date(), '第Q季度', {
- *   customFormatters: {
- *     '第Q季度': (date) => `第${Math.floor((date.getMonth() + 3) / 3)}季度`
- *   }
- * });
- * // 返回: "第4季度"
  * ```
+ *
+ * @remarks
+ * ## 支持的格式化标记
+ *
+ * ### 年份
+ * - `YYYY`: 4位年份 (2024)
+ * - `YY`: 2位年份 (24)
+ *
+ * ### 月份
+ * - `MMMM`: 完整月份名称 (January / 一月)
+ * - `MMM`: 月份缩写 (Jan / 1月)
+ * - `MM`: 2位月份 (01-12)
+ * - `M`: 1-2位月份 (1-12)
+ *
+ * ### 日期
+ * - `DDD`: 一年中的第几天 (001-366)
+ * - `DD`: 2位日期 (01-31)
+ * - `D`: 1-2位日期 (1-31)
+ * - `Do`: 带序数词的日期 (1st, 2nd, 3rd, 4th / 1日, 2日, 3日)
+ *
+ * ### 星期
+ * - `dddd`: 完整星期名称 (Monday / 星期一)
+ * - `ddd`: 星期缩写 (Mon / 周一)
+ * - `d`: 星期数字 (0-6, 0=周日)
+ *
+ * ### 时间
+ * - `HH`: 24小时制，2位 (00-23)
+ * - `H`: 24小时制，1-2位 (0-23)
+ * - `hh`: 12小时制，2位 (01-12)
+ * - `h`: 12小时制，1-2位 (1-12)
+ * - `mm`: 2位分钟 (00-59)
+ * - `m`: 1-2位分钟 (0-59)
+ * - `ss`: 2位秒 (00-59)
+ * - `s`: 1-2位秒 (0-59)
+ * - `SSS`: 3位毫秒 (000-999)
+ * - `S`: 毫秒 (0-999)
+ *
+ * ### 其他
+ * - `A`: 大写AM/PM
+ * - `a`: 小写am/pm
+ * - `Q`: 季度 (1-4)
+ * - `WW`: 2位周数 (01-53)
+ * - `W`: 1-2位周数 (1-53)
+ * - `X`: Unix时间戳 (秒)
+ * - `x`: Unix时间戳 (毫秒)
+ * - `timestamp`: Unix时间戳 (毫秒，与x相同)
  */
 declare function formatDate(input: DateInput, formatStr?: string, options?: Partial<DateFormatOptions>): string;
 export default formatDate;

package/dist/date/formatDate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatDate.d.ts","sourceRoot":"","sources":["../../src/date/formatDate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AA4D7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,iBAAS,UAAU,CACjB,KAAK,EAAE,SAAS,EAChB,SAAS,GAAE,MAA8B,EACzC,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACvC,MAAM,CAuFR;AAED,eAAe,UAAU,CAAC"}
+{"version":3,"file":"formatDate.d.ts","sourceRoot":"","sources":["../../src/date/formatDate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAoD7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AACH,iBAAS,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,GAAE,MAA8B,EAAE,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,MAAM,CAqHjI;AAED,eAAe,UAAU,CAAC"}

package/dist/date/formatDate.js

@@ -11,7 +11,7 @@ function safeParseDate(input) {
     if (input instanceof Date && !isNaN(input.getTime())) {
         return input;
     }
-    if (typeof input === "string" || typeof input === "number") {
+    if (typeof input === 'string' || typeof input === 'number') {
         const date = new Date(input);
         if (!isNaN(date.getTime())) {
             return date;
@@ -42,9 +42,8 @@ function getWeekNumber(date) {
  * @internal
  */
 function getLocalizedWeekday(weekday, options) {
-    const lang = options.locale?.split("-")[0] || "zh";
-    return (constants_1.WEEKDAY_MAP[lang]?.[weekday] ||
-        constants_1.WEEKDAY_MAP.zh[weekday]);
+    const lang = options.locale?.split('-')[0] || 'zh';
+    return constants_1.WEEKDAY_MAP[lang]?.[weekday] || constants_1.WEEKDAY_MAP.zh[weekday];
 }
 /**
  * 格式化日期对象
@@ -65,25 +64,55 @@ function getLocalizedWeekday(weekday, options) {
  * // 自定义格式
  * formatDate('2023-12-25', 'YYYY年MM月DD日');
  * // 返回: "2023年12月25日"
+ * ```
  *
- * // 使用 dd 标记显示周几
- * formatDate(new Date(), 'dd HH:mm');
- * // 返回: "周一 14:30"
+ * @remarks
+ * ## 支持的格式化标记
  *
- * // 英文环境显示周几
- * formatDate(new Date(), 'dd HH:mm', { locale: 'en-US' });
- * // 返回: "Monday 14:30"
+ * ### 年份
+ * - `YYYY`: 4位年份 (2024)
+ * - `YY`: 2位年份 (24)
  *
- * // 自定义格式化器
- * formatDate(new Date(), '第Q季度', {
- *   customFormatters: {
- *     '第Q季度': (date) => `第${Math.floor((date.getMonth() + 3) / 3)}季度`
- *   }
- * });
- * // 返回: "第4季度"
- * ```
+ * ### 月份
+ * - `MMMM`: 完整月份名称 (January / 一月)
+ * - `MMM`: 月份缩写 (Jan / 1月)
+ * - `MM`: 2位月份 (01-12)
+ * - `M`: 1-2位月份 (1-12)
+ *
+ * ### 日期
+ * - `DDD`: 一年中的第几天 (001-366)
+ * - `DD`: 2位日期 (01-31)
+ * - `D`: 1-2位日期 (1-31)
+ * - `Do`: 带序数词的日期 (1st, 2nd, 3rd, 4th / 1日, 2日, 3日)
+ *
+ * ### 星期
+ * - `dddd`: 完整星期名称 (Monday / 星期一)
+ * - `ddd`: 星期缩写 (Mon / 周一)
+ * - `d`: 星期数字 (0-6, 0=周日)
+ *
+ * ### 时间
+ * - `HH`: 24小时制，2位 (00-23)
+ * - `H`: 24小时制，1-2位 (0-23)
+ * - `hh`: 12小时制，2位 (01-12)
+ * - `h`: 12小时制，1-2位 (1-12)
+ * - `mm`: 2位分钟 (00-59)
+ * - `m`: 1-2位分钟 (0-59)
+ * - `ss`: 2位秒 (00-59)
+ * - `s`: 1-2位秒 (0-59)
+ * - `SSS`: 3位毫秒 (000-999)
+ * - `S`: 毫秒 (0-999)
+ *
+ * ### 其他
+ * - `A`: 大写AM/PM
+ * - `a`: 小写am/pm
+ * - `Q`: 季度 (1-4)
+ * - `WW`: 2位周数 (01-53)
+ * - `W`: 1-2位周数 (1-53)
+ * - `X`: Unix时间戳 (秒)
+ * - `x`: Unix时间戳 (毫秒)
+ * - `timestamp`: Unix时间戳 (毫秒，与x相同)
  */
-function formatDate(input, formatStr = "YYYY-MM-DD HH:mm:ss", options = {}) {
+function formatDate(input, formatStr = 'YYYY-MM-DD HH:mm:ss', options = {}) {
     const date = safeParseDate(input);
     const mergedOptions = { ...constants_1.DEFAULT_DATE_FORMAT_OPTIONS, ...options };
     // 获取日期各部分
@@ -97,41 +126,70 @@ function formatDate(input, formatStr = "YYYY-MM-DD HH:mm:ss", options = {}) {
     const weekday = date.getDay();
     const quarter = Math.floor((date.getMonth() + 3) / 3);
     const weekNumber = getWeekNumber(date);
+    // 一年中的第几天
+    const firstDayOfYear = new Date(year, 0, 1);
+    const dayOfYear = Math.ceil((date.getTime() - firstDayOfYear.getTime()) / (1000 * 60 * 60 * 24));
+    // 序数词后缀
+    const getOrdinalSuffix = (num) => {
+        const suffixes = ['th', 'st', 'nd', 'rd'];
+        const v = num % 100;
+        return suffixes[(v - 20) % 10] || suffixes[v] || suffixes[0];
+    };
+    // Unix 时间戳
+    const timestampSeconds = Math.floor(date.getTime() / 1000);
+    const timestampMilliseconds = date.getTime();
+    // 月份名称和缩写
+    const getMonthName = (date, locale, full = false) => {
+        return date.toLocaleString(locale, { month: full ? 'long' : 'short' });
+    };
+    // 星期名称和缩写
+    const getWeekdayName = (date, locale, full = false) => {
+        return date.toLocaleString(locale, { weekday: full ? 'long' : 'short' });
+    };
     // 12小时制
     const hours12 = hours % 12 || 12;
-    const ampm = hours < 12 ? "AM" : "PM";
+    const ampm = hours < 12 ? 'AM' : 'PM';
     const ampmLower = ampm.toLowerCase();
     // 1. 首先处理完整的单词标记（如 timestamp）
     let result = formatStr;
     // 优先替换 timestamp，避免被拆解
-    if (result.includes("timestamp")) {
+    if (result.includes('timestamp')) {
         result = result.replace(/timestamp/g, date.getTime().toString());
     }
     // 2. 应用自定义格式化器（优先级最高）
     if (mergedOptions.customFormatters) {
         Object.entries(mergedOptions.customFormatters).forEach(([token, formatter]) => {
-            const escapedToken = token.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-            const regex = new RegExp(`(?<![a-zA-Z0-9])${escapedToken}(?![a-zA-Z0-9])`, "g");
+            const escapedToken = token.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            const regex = new RegExp(`(?<![a-zA-Z0-9])${escapedToken}(?![a-zA-Z0-9])`, 'g');
             result = result.replace(regex, formatter(date));
         });
     }
     // 3. 替换多字符标记（2-4个字符）
+    // 注意：长标记需要先于短标记处理，避免被部分匹配
     const multiCharReplacements = {
-        YYYY: year.toString().padStart(4, "0"),
+        YYYY: year.toString().padStart(4, '0'),
         YY: year.toString().slice(-2),
-        MM: month.toString().padStart(2, "0"),
-        DD: day.toString().padStart(2, "0"),
-        HH: hours.toString().padStart(2, "0"),
-        hh: hours12.toString().padStart(2, "0"),
-        mm: minutes.toString().padStart(2, "0"),
-        ss: seconds.toString().padStart(2, "0"),
-        SSS: milliseconds.toString().padStart(3, "0"),
-        WW: weekNumber.toString().padStart(2, "0"),
+        MMMM: getMonthName(date, mergedOptions.locale || constants_1.DEFAULT_DATE_FORMAT_OPTIONS.locale, true),
+        MMM: getMonthName(date, mergedOptions.locale || constants_1.DEFAULT_DATE_FORMAT_OPTIONS.locale, false),
+        MM: month.toString().padStart(2, '0'),
+        DDD: dayOfYear.toString().padStart(3, '0'),
+        DD: day.toString().padStart(2, '0'),
+        HH: hours.toString().padStart(2, '0'),
+        hh: hours12.toString().padStart(2, '0'),
+        mm: minutes.toString().padStart(2, '0'),
+        ss: seconds.toString().padStart(2, '0'),
+        SSS: milliseconds.toString().padStart(3, '0'),
+        WW: weekNumber.toString().padStart(2, '0'),
+        dddd: getWeekdayName(date, mergedOptions.locale || constants_1.DEFAULT_DATE_FORMAT_OPTIONS.locale, true),
+        ddd: getWeekdayName(date, mergedOptions.locale || constants_1.DEFAULT_DATE_FORMAT_OPTIONS.locale, false),
         dd: getLocalizedWeekday(weekday, mergedOptions),
+        Do: `${day}${getOrdinalSuffix(day)}`,
+        X: timestampSeconds.toString(),
+        x: timestampMilliseconds.toString(),
     };
     Object.entries(multiCharReplacements).forEach(([token, value]) => {
         // 使用单词边界或字符串边界来确保精确匹配
-        const regex = new RegExp(`\\b${token}\\b|${token}(?![a-zA-Z0-9])`, "g");
+        const regex = new RegExp(`\\b${token}\\b|${token}(?![a-zA-Z0-9])`, 'g');
         result = result.replace(regex, value);
     });
     // 4. 替换单字符标记（使用更精确的匹配）
@@ -143,6 +201,7 @@ function formatDate(input, formatStr = "YYYY-MM-DD HH:mm:ss", options = {}) {
         h: hours12.toString(),
         m: minutes.toString(),
         s: seconds.toString(),
+        S: milliseconds.toString(),
         W: weekNumber.toString(),
         d: weekday.toString(),
         Q: quarter.toString(),
@@ -151,7 +210,7 @@ function formatDate(input, formatStr = "YYYY-MM-DD HH:mm:ss", options = {}) {
     };
     Object.entries(singleCharReplacements).forEach(([token, value]) => {
         // 单字符需要更精确的匹配：前面是边界或特定字符，后面不是相同字符
-        const regex = new RegExp(`(?<![a-zA-Z0-9])${token}(?![a-zA-Z0-9])`, "g");
+        const regex = new RegExp(`(?<![a-zA-Z0-9])${token}(?![a-zA-Z0-9])`, 'g');
         result = result.replace(regex, value);
     });
     return result;

package/dist/date/formatDate.js.map

@@ -1 +1 @@
-{"version":3,"file":"formatDate.js","sourceRoot":"","sources":["../../src/date/formatDate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"formatDate.js","sourceRoot":"","sources":["../../src/date/formatDate.ts"],"names":[],"mappings":"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"}

package/dist/date/formatDateCompiled.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 编译模式日期格式化实现
+ * 首次调用编译格式化字符串，后续调用使用缓存的编译函数
+ */
+import { DateFormatOptions, DateInput } from '../types/date';
+/**
+ * 编译后的格式化函数类型
+ */
+type CompiledFormatter = (date: Date, options: DateFormatOptions) => string;
+/**
+ * 编译格式化字符串，生成优化的格式化函数
+ * @param formatStr - 格式化字符串
+ * @returns 编译后的格式化函数
+ */
+export declare function compileFormat(formatStr: string): CompiledFormatter;
+/**
+ * 清除格式化缓存
+ * @param formatStr - 可选，指定要清除的格式化字符串缓存
+ */
+export declare function clearFormatCache(formatStr?: string): void;
+/**
+ * 编译模式日期格式化
+ * @param input - 要格式化的日期输入
+ * @param formatStr - 格式化字符串
+ * @param options - 格式化选项
+ * @returns 格式化后的日期字符串
+ */
+export declare function formatDateCompiled(input: DateInput, formatStr?: string, options?: Partial<DateFormatOptions>): string;
+export default formatDateCompiled;
+//# sourceMappingURL=formatDateCompiled.d.ts.map

package/dist/date/formatDateCompiled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDateCompiled.d.ts","sourceRoot":"","sources":["../../src/date/formatDateCompiled.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI7D;;GAEG;AACH,KAAK,iBAAiB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,KAAK,MAAM,CAAC;AAO5E;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CA0FlE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAMzD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAC9B,KAAK,EAAE,SAAS,EAChB,SAAS,GAAE,MAA8B,EACzC,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACzC,MAAM,CASR;AAED,eAAe,kBAAkB,CAAC"}

package/dist/date/formatDateCompiled.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDateCompiled = exports.clearFormatCache = exports.compileFormat = void 0;
+const constants_1 = require("../utils/constants");
+const formatDatePlain_1 = require("./formatDatePlain");
+/**
+ * 格式化缓存，用于存储编译后的格式化函数
+ */
+const FORMAT_CACHE = new Map();
+/**
+ * 编译格式化字符串，生成优化的格式化函数
+ * @param formatStr - 格式化字符串
+ * @returns 编译后的格式化函数
+ */
+function compileFormat(formatStr) {
+    // 检查缓存
+    if (FORMAT_CACHE.has(formatStr)) {
+        return FORMAT_CACHE.get(formatStr);
+    }
+    // 生成编译后的函数
+    const compiledFn = (date, options) => {
+        // 获取日期各部分
+        const year = date.getFullYear();
+        const month = date.getMonth() + 1;
+        const day = date.getDate();
+        const hours = date.getHours();
+        const minutes = date.getMinutes();
+        const seconds = date.getSeconds();
+        const milliseconds = date.getMilliseconds();
+        const weekday = date.getDay();
+        const quarter = Math.floor((date.getMonth() + 3) / 3);
+        const weekNumber = (0, formatDatePlain_1.getWeekNumber)(date);
+        // 12小时制
+        const hours12 = hours % 12 || 12;
+        const ampm = hours < 12 ? 'AM' : 'PM';
+        const ampmLower = ampm.toLowerCase();
+        let result = formatStr;
+        // 优先替换 timestamp，避免被拆解
+        if (result.includes('timestamp')) {
+            result = result.replace(/timestamp/g, date.getTime().toString());
+        }
+        // 2. 应用自定义格式化器（优先级最高）
+        if (options.customFormatters) {
+            Object.entries(options.customFormatters).forEach(([token, formatter]) => {
+                const escapedToken = token.replace(/[.*+?^${}()|[\\]/g, '\\$&');
+                const regex = new RegExp(`(?<![a-zA-Z0-9])${escapedToken}(?![a-zA-Z0-9])`, 'g');
+                result = result.replace(regex, formatter(date));
+            });
+        }
+        // 3. 替换多字符标记（2-4个字符）
+        const multiCharReplacements = {
+            YYYY: year.toString().padStart(4, '0'),
+            YY: year.toString().slice(-2),
+            MM: month.toString().padStart(2, '0'),
+            DD: day.toString().padStart(2, '0'),
+            HH: hours.toString().padStart(2, '0'),
+            hh: hours12.toString().padStart(2, '0'),
+            mm: minutes.toString().padStart(2, '0'),
+            ss: seconds.toString().padStart(2, '0'),
+            SSS: milliseconds.toString().padStart(3, '0'),
+            WW: weekNumber.toString().padStart(2, '0'),
+            dd: (0, formatDatePlain_1.getLocalizedWeekday)(weekday, options),
+        };
+        Object.entries(multiCharReplacements).forEach(([token, value]) => {
+            // 使用单词边界或字符串边界来确保精确匹配
+            const regex = new RegExp(`\\b${token}\\b|${token}(?![a-zA-Z0-9])`, 'g');
+            result = result.replace(regex, value);
+        });
+        // 4. 替换单字符标记（使用更精确的匹配）
+        const singleCharReplacements = {
+            Y: year.toString(),
+            M: month.toString(),
+            D: day.toString(),
+            H: hours.toString(),
+            h: hours12.toString(),
+            m: minutes.toString(),
+            s: seconds.toString(),
+            W: weekNumber.toString(),
+            d: weekday.toString(),
+            Q: quarter.toString(),
+            A: ampm,
+            a: ampmLower,
+        };
+        Object.entries(singleCharReplacements).forEach(([token, value]) => {
+            // 单字符需要更精确的匹配：前面是边界或特定字符，后面不是相同字符
+            const regex = new RegExp(`(?<![a-zA-Z0-9])${token}(?![a-zA-Z0-9])`, 'g');
+            result = result.replace(regex, value);
+        });
+        return result;
+    };
+    // 缓存编译结果
+    FORMAT_CACHE.set(formatStr, compiledFn);
+    return compiledFn;
+}
+exports.compileFormat = compileFormat;
+/**
+ * 清除格式化缓存
+ * @param formatStr - 可选，指定要清除的格式化字符串缓存
+ */
+function clearFormatCache(formatStr) {
+    if (formatStr) {
+        FORMAT_CACHE.delete(formatStr);
+    }
+    else {
+        FORMAT_CACHE.clear();
+    }
+}
+exports.clearFormatCache = clearFormatCache;
+/**
+ * 编译模式日期格式化
+ * @param input - 要格式化的日期输入
+ * @param formatStr - 格式化字符串
+ * @param options - 格式化选项
+ * @returns 格式化后的日期字符串
+ */
+function formatDateCompiled(input, formatStr = 'YYYY-MM-DD HH:mm:ss', options = {}) {
+    const date = (0, formatDatePlain_1.safeParseDate)(input);
+    const mergedOptions = { ...constants_1.DEFAULT_DATE_FORMAT_OPTIONS, ...options };
+    // 编译并缓存格式化函数
+    const formatter = compileFormat(formatStr);
+    // 使用编译后的函数格式化日期
+    return formatter(date, mergedOptions);
+}
+exports.formatDateCompiled = formatDateCompiled;
+exports.default = formatDateCompiled;
+//# sourceMappingURL=formatDateCompiled.js.map

package/dist/date/formatDateCompiled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDateCompiled.js","sourceRoot":"","sources":["../../src/date/formatDateCompiled.ts"],"names":[],"mappings":"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"}

package/dist/date/formatDatePlain.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 普通模式日期格式化实现
+ * 每次调用都会重新解析格式化字符串
+ */
+import { DateFormatOptions, DateInput } from '../types/date';
+/**
+ * 将各种输入类型安全地转换为 Date 对象
+ * @param input - 日期输入
+ * @returns 转换后的 Date 对象，无效输入返回当前时间
+ */
+export declare function safeParseDate(input: DateInput): Date;
+/**
+ * 计算一年中的第几周 (ISO 8601)
+ * @param date - 日期对象
+ * @returns 周数
+ */
+export declare function getWeekNumber(date: Date): number;
+/**
+ * 获取本地化的星期几
+ * @param weekday - 星期几 (0-6)
+ * @param options - 格式化选项
+ * @returns 本地化的星期几字符串
+ */
+export declare function getLocalizedWeekday(weekday: number, options: DateFormatOptions): string;
+/**
+ * 普通模式日期格式化
+ * @param input - 要格式化的日期输入
+ * @param formatStr - 格式化字符串
+ * @param options - 格式化选项
+ * @returns 格式化后的日期字符串
+ */
+export declare function formatDatePlain(input: DateInput, formatStr?: string, options?: Partial<DateFormatOptions>): string;
+export default formatDatePlain;
+//# sourceMappingURL=formatDatePlain.d.ts.map

package/dist/date/formatDatePlain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDatePlain.d.ts","sourceRoot":"","sources":["../../src/date/formatDatePlain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG7D;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAepD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAMhD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAGvF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC3B,KAAK,EAAE,SAAS,EAChB,SAAS,GAAE,MAA8B,EACzC,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACzC,MAAM,CA+ER;AAED,eAAe,eAAe,CAAC"}

package/dist/date/formatDatePlain.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDatePlain = exports.getLocalizedWeekday = exports.getWeekNumber = exports.safeParseDate = void 0;
+const constants_1 = require("../utils/constants");
+/**
+ * 将各种输入类型安全地转换为 Date 对象
+ * @param input - 日期输入
+ * @returns 转换后的 Date 对象，无效输入返回当前时间
+ */
+function safeParseDate(input) {
+    if (input instanceof Date && !isNaN(input.getTime())) {
+        return input;
+    }
+    if (typeof input === 'string' || typeof input === 'number') {
+        const date = new Date(input);
+        if (!isNaN(date.getTime())) {
+            return date;
+        }
+    }
+    // 无效输入返回当前时间
+    console.warn(`Invalid date input: ${input}, using current date instead.`);
+    return new Date();
+}
+exports.safeParseDate = safeParseDate;
+/**
+ * 计算一年中的第几周 (ISO 8601)
+ * @param date - 日期对象
+ * @returns 周数
+ */
+function getWeekNumber(date) {
+    const d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+    const dayNum = d.getUTCDay() || 7;
+    d.setUTCDate(d.getUTCDate() + 4 - dayNum);
+    const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+    return Math.ceil(((d.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);
+}
+exports.getWeekNumber = getWeekNumber;
+/**
+ * 获取本地化的星期几
+ * @param weekday - 星期几 (0-6)
+ * @param options - 格式化选项
+ * @returns 本地化的星期几字符串
+ */
+function getLocalizedWeekday(weekday, options) {
+    const lang = options.locale?.split('-')[0] || 'zh';
+    return constants_1.WEEKDAY_MAP[lang]?.[weekday] || constants_1.WEEKDAY_MAP.zh[weekday];
+}
+exports.getLocalizedWeekday = getLocalizedWeekday;
+/**
+ * 普通模式日期格式化
+ * @param input - 要格式化的日期输入
+ * @param formatStr - 格式化字符串
+ * @param options - 格式化选项
+ * @returns 格式化后的日期字符串
+ */
+function formatDatePlain(input, formatStr = 'YYYY-MM-DD HH:mm:ss', options = {}) {
+    const date = safeParseDate(input);
+    const mergedOptions = { ...constants_1.DEFAULT_DATE_FORMAT_OPTIONS, ...options };
+    // 获取日期各部分
+    const year = date.getFullYear();
+    const month = date.getMonth() + 1;
+    const day = date.getDate();
+    const hours = date.getHours();
+    const minutes = date.getMinutes();
+    const seconds = date.getSeconds();
+    const milliseconds = date.getMilliseconds();
+    const weekday = date.getDay();
+    const quarter = Math.floor((date.getMonth() + 3) / 3);
+    const weekNumber = getWeekNumber(date);
+    // 12小时制
+    const hours12 = hours % 12 || 12;
+    const ampm = hours < 12 ? 'AM' : 'PM';
+    const ampmLower = ampm.toLowerCase();
+    let result = formatStr;
+    // 优先替换 timestamp，避免被拆解
+    if (result.includes('timestamp')) {
+        result = result.replace(/timestamp/g, date.getTime().toString());
+    }
+    // 2. 应用自定义格式化器（优先级最高）
+    if (mergedOptions.customFormatters) {
+        Object.entries(mergedOptions.customFormatters).forEach(([token, formatter]) => {
+            const escapedToken = token.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            const regex = new RegExp(`(?<![a-zA-Z0-9])${escapedToken}(?![a-zA-Z0-9])`, 'g');
+            result = result.replace(regex, formatter(date));
+        });
+    }
+    // 3. 替换多字符标记（2-4个字符）
+    const multiCharReplacements = {
+        YYYY: year.toString().padStart(4, '0'),
+        YY: year.toString().slice(-2),
+        MM: month.toString().padStart(2, '0'),
+        DD: day.toString().padStart(2, '0'),
+        HH: hours.toString().padStart(2, '0'),
+        hh: hours12.toString().padStart(2, '0'),
+        mm: minutes.toString().padStart(2, '0'),
+        ss: seconds.toString().padStart(2, '0'),
+        SSS: milliseconds.toString().padStart(3, '0'),
+        WW: weekNumber.toString().padStart(2, '0'),
+        dd: getLocalizedWeekday(weekday, mergedOptions),
+    };
+    Object.entries(multiCharReplacements).forEach(([token, value]) => {
+        const regex = new RegExp(`\\b${token}\\b|${token}(?![a-zA-Z0-9])`, 'g');
+        result = result.replace(regex, value);
+    });
+    // 4. 替换单字符标记（使用更精确的匹配）
+    const singleCharReplacements = {
+        Y: year.toString(),
+        M: month.toString(),
+        D: day.toString(),
+        H: hours.toString(),
+        h: hours12.toString(),
+        m: minutes.toString(),
+        s: seconds.toString(),
+        W: weekNumber.toString(),
+        d: weekday.toString(),
+        Q: quarter.toString(),
+        A: ampm,
+        a: ampmLower,
+    };
+    Object.entries(singleCharReplacements).forEach(([token, value]) => {
+        const regex = new RegExp(`(?<![a-zA-Z0-9])${token}(?![a-zA-Z0-9])`, 'g');
+        result = result.replace(regex, value);
+    });
+    return result;
+}
+exports.formatDatePlain = formatDatePlain;
+exports.default = formatDatePlain;
+//# sourceMappingURL=formatDatePlain.js.map

package/dist/date/formatDatePlain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDatePlain.js","sourceRoot":"","sources":["../../src/date/formatDatePlain.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -3,13 +3,13 @@
  *
  * @module @planarcat/js-toolkit
  */
-export { default as formatDate } from "./date/formatDate";
-export type { DateFormatOptions, DateInput } from "./types/date";
-export { default as debounce } from "./function/debounce";
-export type { DebounceOptions, DebouncedFunction } from "./types/function";
+export { default as formatDate } from './date/formatDate';
+export type { DateFormatOptions, DateInput } from './types/date';
+export { default as debounce } from './function/debounce';
+export type { DebounceOptions, DebouncedFunction } from './types/function';
 export declare const VERSION = "__VERSION__";
 export declare const LIBRARY_NAME = "@planarcat/js-toolkit";
-export { default as toFormattedNumber } from "./object/toFormattedNumber";
-export { default as toFormattedNumberString } from "./object/toFormattedNumberString";
-export type { ToFormattedNumberOptions, ToFormattedNumberStringOptions, } from "./types/object";
+export { default as toFormattedNumber } from './object/toFormattedNumber';
+export { default as toFormattedNumberString } from './object/toFormattedNumberString';
+export type { ToFormattedNumberOptions, ToFormattedNumberStringOptions } from './types/object';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGjE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG3E,eAAO,MAAM,OAAO,gBAAgB,CAAC;AACrC,eAAO,MAAM,YAAY,0BAA0B,CAAC;AAGpD,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AACtF,YAAY,EACV,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGjE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG3E,eAAO,MAAM,OAAO,gBAAgB,CAAC;AACrC,eAAO,MAAM,YAAY,0BAA0B,CAAC;AAGpD,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AACtF,YAAY,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -16,8 +16,8 @@ Object.defineProperty(exports, "formatDate", { enumerable: true, get: function (
 var debounce_1 = require("./function/debounce");
 Object.defineProperty(exports, "debounce", { enumerable: true, get: function () { return __importDefault(debounce_1).default; } });
 // 工具库元数据
-exports.VERSION = "__VERSION__"; // 构建时替换
-exports.LIBRARY_NAME = "@planarcat/js-toolkit";
+exports.VERSION = '__VERSION__'; // 构建时替换
+exports.LIBRARY_NAME = '@planarcat/js-toolkit';
 // 对象相关工具
 var toFormattedNumber_1 = require("./object/toFormattedNumber");
 Object.defineProperty(exports, "toFormattedNumber", { enumerable: true, get: function () { return __importDefault(toFormattedNumber_1).default; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAEH,SAAS;AACT,gDAA0D;AAAjD,yHAAA,OAAO,OAAc;AAG9B,SAAS;AACT,gDAA0D;AAAjD,qHAAA,OAAO,OAAY;AAG5B,SAAS;AACI,QAAA,OAAO,GAAG,aAAa,CAAC,CAAC,QAAQ;AACjC,QAAA,YAAY,GAAG,uBAAuB,CAAC;AAEpD,SAAS;AACT,gEAA0E;AAAjE,uIAAA,OAAO,OAAqB;AACrC,4EAAsF;AAA7E,mJAAA,OAAO,OAA2B;AAM3C,aAAa;AACb,2DAA2D"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAEH,SAAS;AACT,gDAA0D;AAAjD,yHAAA,OAAO,OAAc;AAG9B,SAAS;AACT,gDAA0D;AAAjD,qHAAA,OAAO,OAAY;AAG5B,SAAS;AACI,QAAA,OAAO,GAAG,aAAa,CAAC,CAAC,QAAQ;AACjC,QAAA,YAAY,GAAG,uBAAuB,CAAC;AAEpD,SAAS;AACT,gEAA0E;AAAjE,uIAAA,OAAO,OAAqB;AACrC,4EAAsF;AAA7E,mJAAA,OAAO,OAA2B;AAG3C,aAAa;AACb,2DAA2D"}

package/dist/object/toFormattedNumberString.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toFormattedNumberString.d.ts","sourceRoot":"","sources":["../../src/object/toFormattedNumberString.ts"],"names":[],"mappings":"AA8DA,iBAAS,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,8BAA8B,GAAG,MAAM,EAAE,CAAC;AAElI,iBAAS,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,8BAA8B,GAAG,MAAM,CAAC;AAiI9H,eAAe,uBAAuB,CAAC"}
+{"version":3,"file":"toFormattedNumberString.d.ts","sourceRoot":"","sources":["../../src/object/toFormattedNumberString.ts"],"names":[],"mappings":"AAsNA,iBAAS,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,8BAA8B,GAAG,MAAM,EAAE,CAAC;AAElI,iBAAS,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,iBAAiB,EAAE,8BAA8B,GAAG,MAAM,CAAC;AAkB9H,eAAe,uBAAuB,CAAC"}

package/dist/object/toFormattedNumberString.js

@@ -63,121 +63,135 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * ```
  */
 const toFormattedNumber_1 = __importDefault(require("./toFormattedNumber"));
-// 主函数实现
-function toFormattedNumberString(object, options) {
-    // 解构并设置默认值
-    const { decimalPlaces = true, nanValue = 'NaN', zeroValue = '0', localized, preProcessor, prefix = '', suffix = '' } = options || {};
-    /**
-     * 添加前缀和后缀
-     * @param prefix - 前缀
-     * @param suffix - 后缀
-     * @param formatted - 格式化后的字符串
-     * @param converted - 转化后的数字
-     * @param original - 原始对象
-     * @returns 添加了前缀后缀的字符串
-     */
-    const addPrefixSuffix = (prefix, suffix, formatted, converted, original) => {
-        let processedPrefix;
-        if (typeof prefix === 'function') {
-            processedPrefix = prefix(original, converted, formatted);
-        }
-        else {
-            processedPrefix = prefix;
-        }
-        let processedSuffix;
-        if (typeof suffix === 'function') {
-            processedSuffix = suffix(original, converted, formatted);
+/**
+ * 检查字符串是否包含数字
+ * @param str - 要检查的字符串
+ * @returns 是否包含数字
+ */
+function hasNumbers(str) {
+    return /\d/.test(str);
+}
+/**
+ * 添加前缀和后缀
+ * @param prefix - 前缀
+ * @param suffix - 后缀
+ * @param formatted - 格式化后的字符串
+ * @param converted - 转化后的数字
+ * @param original - 原始对象
+ * @returns 添加了前缀后缀的字符串
+ */
+function addPrefixSuffix(prefix, suffix, formatted, converted, original) {
+    let processedPrefix;
+    if (typeof prefix === 'function') {
+        processedPrefix = prefix(original, converted, formatted);
+    }
+    else {
+        processedPrefix = prefix;
+    }
+    let processedSuffix;
+    if (typeof suffix === 'function') {
+        processedSuffix = suffix(original, converted, formatted);
+    }
+    else {
+        processedSuffix = suffix;
+    }
+    return `${processedPrefix}${formatted}${processedSuffix}`;
+}
+/**
+ * 将单个数字转换为格式化字符串
+ * @param converted - 原始对象转化为数字后的结果
+ * @param original - 原始对象
+ * @param options - 格式化选项
+ * @returns 格式化后的字符串
+ */
+function format(converted, original, options) {
+    const { decimalPlaces, zeroValue, localized, preProcessor, prefix, suffix } = options;
+    // 处理0情况
+    if (converted === 0) {
+        return addPrefixSuffix(prefix, suffix, zeroValue, converted, original);
+    }
+    // 应用预处理函数
+    const preProcessed = preProcessor ? preProcessor(original, converted) : converted;
+    // 格式化数字为字符串
+    let formatted;
+    if (localized) {
+        // 使用本地化格式
+        if (decimalPlaces === true) {
+            // 保留所有小数位
+            formatted = preProcessed.toLocaleString();
         }
         else {
-            processedSuffix = suffix;
-        }
-        return `${processedPrefix}${formatted}${processedSuffix}`;
-    };
-    /**
-     * 将单个数字转换为格式化字符串
-     * @param converted - 转化后的数字
-     * @param original - 原始对象
-     * @returns 格式化后的字符串
-     */
-    const convertNumberToString = (converted, original) => {
-        // 处理0情况
-        if (converted === 0) {
-            return addPrefixSuffix(prefix, suffix, zeroValue, converted, original);
+            // 保留指定小数位，不够时补0
+            formatted = preProcessed.toLocaleString(undefined, {
+                minimumFractionDigits: decimalPlaces,
+                maximumFractionDigits: decimalPlaces,
+            });
         }
-        // 应用预处理函数
-        const processedNum = preProcessor ? preProcessor(original, converted) : converted;
-        // 格式化数字为字符串
-        let strNum;
-        if (localized) {
-            // 使用本地化格式
-            if (decimalPlaces === true) {
-                // 保留所有小数位
-                strNum = processedNum.toLocaleString();
-            }
-            else {
-                // 保留指定小数位，不够时补0
-                strNum = processedNum.toLocaleString(undefined, {
-                    minimumFractionDigits: decimalPlaces,
-                    maximumFractionDigits: decimalPlaces,
-                });
-            }
+    }
+    else {
+        // 使用非本地化格式
+        if (decimalPlaces === true) {
+            // 保留所有小数位
+            formatted = preProcessed.toString();
         }
         else {
-            // 使用非本地化格式
-            if (decimalPlaces === true) {
-                // 保留所有小数位
-                strNum = processedNum.toString();
-            }
-            else {
-                // 保留指定小数位，不够时补0
-                strNum = processedNum.toFixed(decimalPlaces);
-            }
+            // 保留指定小数位，不够时补0
+            formatted = preProcessed.toFixed(decimalPlaces);
         }
-        // 添加前缀和后缀
-        return addPrefixSuffix(prefix, suffix, strNum, converted, original);
-    };
-    /**
-     * 检查字符串是否包含数字
-     * @param str - 要检查的字符串
-     * @returns 是否包含数字
-     */
-    const hasNumbers = (str) => {
-        return /\d/.test(str);
-    };
-    /**
-     * 递归处理值，转换为格式化字符串
-     * @param value - 要处理的值
-     * @param original - 原始对象或数组元素
-     * @returns 格式化后的字符串或字符串数组
-     */
-    const processValue = (value, original = object) => {
-        if (Array.isArray(value)) {
-            // 递归处理数组
-            return value.map((item, _index) => processValue(item, item));
+    }
+    // 添加前缀和后缀
+    return addPrefixSuffix(prefix, suffix, formatted, converted, original);
+}
+/**
+ * 递归处理值，转换为格式化字符串
+ * @param value - 要处理的值
+ * @param original - 原始对象或数组元素
+ * @param options - 格式化选项
+ * @returns 格式化后的字符串或字符串数组
+ */
+function processValue(value, original, options) {
+    const { decimalPlaces, zeroValue, nanValue, prefix, suffix } = options;
+    if (Array.isArray(value)) {
+        // 递归处理数组
+        return value.map((item, _index) => processValue(item, item, options));
+    }
+    else {
+        // 检查是否为无数字的字符串
+        if (typeof value === 'string' && !hasNumbers(value)) {
+            // 无数字的字符串返回0
+            return addPrefixSuffix(prefix, suffix, zeroValue, 0, original);
         }
-        else {
-            // 检查是否为无数字的字符串
-            if (typeof value === 'string' && !hasNumbers(value)) {
-                // 无数字的字符串返回0
-                return addPrefixSuffix(prefix, suffix, zeroValue, 0, original);
-            }
-            // 对于其他类型，首先将输入转换为数字
-            // 注意：toFormattedNumber对于单个值会返回number类型
-            const num = (0, toFormattedNumber_1.default)(value, {
+        // 对于其他类型，首先将输入转换为数字
+        // 注意：toFormattedNumber对于单个值会返回number类型
+        const converted = typeof value === 'number'
+            ? value
+            : (0, toFormattedNumber_1.default)(value, {
                 decimalPlaces,
                 nanValue: NaN,
             });
-            // 检查是否为NaN
-            if (isNaN(num)) {
-                // 其他NaN情况，使用nanValue
-                return addPrefixSuffix(prefix, suffix, nanValue, num, original);
-            }
-            // 正常数字转换
-            return convertNumberToString(num, original);
+        // 检查是否为NaN
+        if (isNaN(converted)) {
+            // 其他NaN情况，使用nanValue
+            return addPrefixSuffix(prefix, suffix, nanValue, converted, original);
         }
-    };
+        // 正常数字转换
+        return format(converted, original, options);
+    }
+}
+// 主函数实现
+function toFormattedNumberString(object, options) {
+    // 解构并设置默认值
+    const { decimalPlaces = true, nanValue = 'NaN', zeroValue = '0', localized, preProcessor, prefix = '', suffix = '' } = options || {};
     // 处理输入值
-    return processValue(object);
+    return processValue(object, object, {
+        decimalPlaces,
+        zeroValue,
+        nanValue,
+        localized,
+        preProcessor,
+        prefix,
+        suffix,
+    });
 }
 exports.default = toFormattedNumberString;
 //# sourceMappingURL=toFormattedNumberString.js.map

package/dist/object/toFormattedNumberString.js.map

@@ -1 +1 @@
-{"version":3,"file":"toFormattedNumberString.js","sourceRoot":"","sources":["../../src/object/toFormattedNumberString.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"toFormattedNumberString.js","sourceRoot":"","sources":["../../src/object/toFormattedNumberString.ts"],"names":[],"mappings":"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"}

package/dist/types/date.d.ts

@@ -6,7 +6,7 @@ export interface DateFormatOptions {
      * 时区设置
      * @default 'local'
      */
-    timeZone?: "local" | "utc";
+    timeZone?: 'local' | 'utc';
     /**
      * 语言环境
      * @default 'zh-CN'
@@ -20,7 +20,7 @@ export interface DateFormatOptions {
 /**
  * 支持的格式化标记
  */
-export type DateFormatToken = "YYYY" | "YY" | "MM" | "M" | "DD" | "D" | "HH" | "H" | "hh" | "h" | "mm" | "m" | "ss" | "s" | "SSS" | "A" | "a" | "d" | "dd" | "WW" | "W" | "Q" | "timestamp";
+export type DateFormatToken = 'YYYY' | 'YY' | 'MMMM' | 'MMM' | 'MM' | 'M' | 'DDD' | 'DD' | 'D' | 'Do' | 'HH' | 'H' | 'hh' | 'h' | 'mm' | 'm' | 'ss' | 's' | 'SSS' | 'S' | 'A' | 'a' | 'dddd' | 'ddd' | 'd' | 'WW' | 'W' | 'Q' | 'X' | 'x' | 'timestamp';
 /**
  * 可接受的日期输入类型
  */

package/dist/types/date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/types/date.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAE3B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,IAAI,GACJ,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,KAAK,GACL,GAAG,GACH,GAAG,GACH,GAAG,GACH,IAAI,GACJ,IAAI,GACJ,GAAG,GACH,GAAG,GACH,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC"}
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/types/date.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAE3B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACrB,MAAM,GACN,IAAI,GACJ,MAAM,GACN,KAAK,GACL,IAAI,GACJ,GAAG,GACH,KAAK,GACL,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,KAAK,GACL,GAAG,GACH,GAAG,GACH,GAAG,GACH,MAAM,GACN,KAAK,GACL,GAAG,GACH,IAAI,GACJ,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,WAAW,CAAC;AAElB;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@planarcat/js-toolkit",
-    "version": "1.5.5",
+    "version": "1.6.0",
     "description": "一个自用的带学习性质的（目前）现代化的 JavaScript/TypeScript 实用工具库，提供类型安全、高性能的常用函数，包括对象转换、日期处理、函数优化等开发常用工具。",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",