@canvas-components/utils 0.2.1 → 0.2.2

package/README.md

@@ -1,114 +1,141 @@
-# @canvas-components/utils
-
-`@canvas-components/utils` 提供表格包之间可复用的纯原生工具能力，覆盖数据读取、剪贴板写入和导出文件。
-
-## 功能作用
-
+# @canvas-components/utils
+
+`@canvas-components/utils` 提供表格包之间可复用的纯原生工具能力，覆盖日期时间、数据读取、剪贴板写入和导出文件。
+
+## 功能作用
+
 - 写入文本、二维表格文本、JSON 到系统剪贴板
 - 通过 `dataIndex` 安全读取嵌套数据
+- 使用 Day.js 风格的常用 token 格式化日期时间，不依赖 Day.js 运行时
+- 复用数字、金额、百分比、科学计数法和自定义数字格式化
 - 复用数据路径比较、数值约束和矩形命中等纯函数
-- 把行列数据导出为 `csv`、`txt`、`xlsx`
-- 生成导出前的中间文本 / 记录结构
-- 对大批量导出做分片让步，减少主线程长时间阻塞
-
-## 安装方法
-
-```bash
-pnpm add @canvas-components/utils
-```
-
-最低环境要求：
-
-- `Node.js >= 18.12.0`
-- `pnpm >= 9.0.0`
-
-## 使用方法
-
-```ts
-import {
-  copyRows,
-  exportTableToXlsx,
-} from "@canvas-components/utils";
-
-await copyRows([
-  ["姓名", "年龄"],
-  ["张三", 28],
-  ["李四", 31],
-]);
-
-await exportTableToXlsx({
-  fileName: "users.xlsx",
-  rows: [
-    { name: "张三", age: 28 },
-    { name: "李四", age: 31 },
-  ],
-  columns: [
-    { key: "name", title: "姓名", value: (row) => row.name },
-    { key: "age", title: "年龄", value: (row) => row.age },
-  ],
-});
-```
-
-## 属性说明
-
-### `ExportTableColumn<Row>`
-
-| 属性 | 类型 | 说明 |
-| --- | --- | --- |
-| `key` | `string` | 列唯一标识 |
-| `title` | `string` | 导出列标题 |
-| `value` | `(row: Row, index: number) => unknown` | 从行数据中取导出值 |
-
-### `ClipboardCellValue`
-
-支持的剪贴板单元格值类型：
-
-```ts
-type ClipboardCellValue = string | number | boolean | null | undefined;
-```
-
-## 方法说明
-
-### 剪贴板
-
-| 方法 | 签名 | 说明 |
-| --- | --- | --- |
-| `copyText` | `(text: string) => Promise<void>` | 写入纯文本 |
-| `copyRows` | `(rows: ClipboardCellValue[][]) => Promise<void>` | 把二维数据写入剪贴板 |
-| `copyJson` | `(value: unknown, space = 2) => Promise<void>` | 写入 JSON 文本 |
-| `formatRowsForClipboard` | `(rows) => string` | 把二维数据转成制表符文本 |
-
+- 把行列数据导出为 `csv`、`txt`、`xlsx`
+- 生成导出前的中间文本 / 记录结构
+- 对大批量导出做分片让步，减少主线程长时间阻塞
+
+## 安装方法
+
+```bash
+pnpm add @canvas-components/utils
+```
+
+最低环境要求：
+
+- `Node.js >= 18.12.0`
+- `pnpm >= 9.0.0`
+
+## 使用方法
+
+```ts
+import { copyRows, exportTableToXlsx } from "@canvas-components/utils";
+
+await copyRows([
+  ["姓名", "年龄"],
+  ["张三", 28],
+  ["李四", 31],
+]);
+
+await exportTableToXlsx({
+  fileName: "users.xlsx",
+  rows: [
+    { name: "张三", age: 28 },
+    { name: "李四", age: 31 },
+  ],
+  columns: [
+    { key: "name", title: "姓名", value: (row) => row.name },
+    { key: "age", title: "年龄", value: (row) => row.age },
+  ],
+});
+```
+
+## 属性说明
+
+### `ExportTableColumn<Row>`
+
+| 属性    | 类型                                   | 说明               |
+| ------- | -------------------------------------- | ------------------ |
+| `key`   | `string`                               | 列唯一标识         |
+| `title` | `string`                               | 导出列标题         |
+| `value` | `(row: Row, index: number) => unknown` | 从行数据中取导出值 |
+
+### `ClipboardCellValue`
+
+支持的剪贴板单元格值类型：
+
+```ts
+type ClipboardCellValue = string | number | boolean | null | undefined;
+```
+
+## 方法说明
+
+### 剪贴板
+
+| 方法                     | 签名                                              | 说明                     |
+| ------------------------ | ------------------------------------------------- | ------------------------ |
+| `copyText`               | `(text: string) => Promise<void>`                 | 写入纯文本               |
+| `copyRows`               | `(rows: ClipboardCellValue[][]) => Promise<void>` | 把二维数据写入剪贴板     |
+| `copyJson`               | `(value: unknown, space = 2) => Promise<void>`    | 写入 JSON 文本           |
+| `formatRowsForClipboard` | `(rows) => string`                                | 把二维数据转成制表符文本 |
+
 ### 导出
-
-| 方法 | 签名 | 说明 |
-| --- | --- | --- |
-| `mapRowsToExportRecords` | `({ rows, columns }) => Record<string, unknown>[]` | 生成导出记录数组 |
-| `buildCsvContent` | `({ rows, columns }) => string` | 生成 CSV 文本 |
-| `serializeCsvRows` | `(rows, lineBreak?) => string` | 将二维数据序列化为 CSV 文本 |
-| `buildTxtContent` | `({ rows, columns }) => string` | 生成 TXT 文本 |
-| `downloadJsonFile` | `({ fileName, data, space? }) => Promise<void>` | 下载 JSON |
-| `exportTableToCsv` | `({ fileName, rows, columns }) => Promise<void>` | 导出 CSV |
-| `exportTableToTxt` | `({ fileName, rows, columns }) => Promise<void>` | 导出 TXT |
-| `exportTableToXlsx` | `({ fileName, rows, columns, sheetName? }) => Promise<void>` | 导出 XLSX |
+
+| 方法                     | 签名                                                         | 说明                        |
+| ------------------------ | ------------------------------------------------------------ | --------------------------- |
+| `mapRowsToExportRecords` | `({ rows, columns }) => Record<string, unknown>[]`           | 生成导出记录数组            |
+| `buildCsvContent`        | `({ rows, columns }) => string`                              | 生成 CSV 文本               |
+| `serializeCsvRows`       | `(rows, lineBreak?) => string`                               | 将二维数据序列化为 CSV 文本 |
+| `buildTxtContent`        | `({ rows, columns }) => string`                              | 生成 TXT 文本               |
+| `downloadJsonFile`       | `({ fileName, data, space? }) => Promise<void>`              | 下载 JSON                   |
+| `exportTableToCsv`       | `({ fileName, rows, columns }) => Promise<void>`             | 导出 CSV                    |
+| `exportTableToTxt`       | `({ fileName, rows, columns }) => Promise<void>`             | 导出 TXT                    |
+| `exportTableToXlsx`      | `({ fileName, rows, columns, sheetName? }) => Promise<void>` | 导出 XLSX                   |
 
 ### 数据读取
 
-| 方法 | 签名 | 说明 |
-| --- | --- | --- |
+| 方法                  | 签名                              | 说明                                         |
+| --------------------- | --------------------------------- | -------------------------------------------- |
 | `getValueByDataIndex` | `(source, dataIndex?) => unknown` | 通过字符串、数字或属性路径数组安全读取嵌套值 |
-| `stringifyDataIndex` | `(dataIndex) => string` | 将属性路径转换为稳定字符串 |
-| `isSameDataIndex` | `(left, right) => boolean` | 判断两个属性路径是否一致 |
+| `stringifyDataIndex`  | `(dataIndex) => string`           | 将属性路径转换为稳定字符串                   |
+| `isSameDataIndex`     | `(left, right) => boolean`        | 判断两个属性路径是否一致                     |
+
+### 日期时间
+
+可从主入口或 `@canvas-components/utils/date` 子路径引入。
+
+| 方法                      | 签名                                          | 说明                                           |
+| ------------------------- | --------------------------------------------- | ---------------------------------------------- |
+| `resolveDateValue`        | `(value: unknown) => Date \| null`            | 将日期、时间戳或日期字符串解析为有效日期       |
+| `isDateTimeFormatPattern` | `(pattern: string) => boolean`                | 判断是否包含日期时间格式 token                 |
+| `formatDateTimeValue`     | `(value, pattern, locale?) => string \| null` | 按格式字符串输出日期时间，默认使用中文区域设置 |
+
+常用 token 包括 `YYYY`、`YY`、`M`、`MM`、`D`、`DD`、`ddd`、`dddd`、`H`、`HH`、`h`、`hh`、`m`、`mm`、`s`、`ss`、`SSS`、`A`。方括号中的内容按普通文本输出，例如 `YYYY年M月D日 [更新]`。
+
+### 数字格式
+
+可从主入口或 `@canvas-components/utils/number` 子路径引入。
+
+| 方法                        | 签名                                 | 说明                                         |
+| --------------------------- | ------------------------------------ | -------------------------------------------- |
+| `parseNumberValue`          | `(value: unknown) => number \| null` | 解析数字和带千分位的数字字符串               |
+| `formatNumberValue`         | `(value, options?) => string`        | 格式化数字、金额和千分位数字                 |
+| `formatPercentValue`        | `(value, decimalPlaces?) => string`  | 将比例数值格式化为百分比                     |
+| `formatScientificValue`     | `(value, decimalPlaces?) => string`  | 格式化科学计数法                             |
+| `formatCustomNumberPattern` | `(value, pattern) => string`         | 按常见表格数字 pattern 格式化                |
+| `formatChineseNumber`       | `(value, style?) => string \| null`  | 将数字转换为普通或金融大写中文数字           |
+| `parseChineseNumber`        | `(value) => number \| null`          | 将规范的普通或金融大写中文数字转为阿拉伯数字 |
+
+金融大写使用规范数字字符，例如 `918000` 输出 `玖拾壹万捌仟`；不兼容形近字或错别字。
 
 ### 基础几何
 
-| 方法 | 签名 | 说明 |
-| --- | --- | --- |
-| `clamp` | `(value, minimum, maximum) => number` | 将数值限制在闭区间内 |
-| `isPointInRect` | `(x, y, rect) => boolean` | 判断坐标是否位于矩形内 |
-
-## 适用场景
-
-- 表格导出
-- 系统复制功能
-- 大批量数据下载
-- 非 React 项目里的浏览器工具函数复用
+| 方法            | 签名                                  | 说明                   |
+| --------------- | ------------------------------------- | ---------------------- |
+| `clamp`         | `(value, minimum, maximum) => number` | 将数值限制在闭区间内   |
+| `isPointInRect` | `(x, y, rect) => boolean`             | 判断坐标是否位于矩形内 |
+
+## 适用场景
+
+- 表格导出
+- 系统复制功能
+- 大批量数据下载
+- 非 React 项目里的浏览器工具函数复用

package/dist/date/index.cjs

@@ -0,0 +1,162 @@
+'use strict';
+
+// src/date/index.ts
+var DATE_TIME_FORMAT_TOKEN = /Y{2,4}|M{1,4}|D{1,2}|d{1,4}|H{1,2}|h{1,2}|m{1,2}|s{1,2}|S{1,3}|A|a/;
+var FORMAT_TOKEN = /\[[^\]]*\]|YYYY|MMMM|MMM|dddd|ddd|SSS|YY|MM|DD|dd|HH|hh|mm|ss|SS|M|D|d|H|h|m|s|S|A|a/g;
+var ZH_WEEKDAYS = [
+  "\u661F\u671F\u65E5",
+  "\u661F\u671F\u4E00",
+  "\u661F\u671F\u4E8C",
+  "\u661F\u671F\u4E09",
+  "\u661F\u671F\u56DB",
+  "\u661F\u671F\u4E94",
+  "\u661F\u671F\u516D"
+];
+var ZH_WEEKDAYS_SHORT = [
+  "\u5468\u65E5",
+  "\u5468\u4E00",
+  "\u5468\u4E8C",
+  "\u5468\u4E09",
+  "\u5468\u56DB",
+  "\u5468\u4E94",
+  "\u5468\u516D"
+];
+var EN_WEEKDAYS = [
+  "Sunday",
+  "Monday",
+  "Tuesday",
+  "Wednesday",
+  "Thursday",
+  "Friday",
+  "Saturday"
+];
+var EN_MONTHS = [
+  "January",
+  "February",
+  "March",
+  "April",
+  "May",
+  "June",
+  "July",
+  "August",
+  "September",
+  "October",
+  "November",
+  "December"
+];
+function resolveDateValue(value) {
+  if (value instanceof Date) {
+    return Number.isNaN(value.getTime()) ? null : value;
+  }
+  if (typeof value !== "string" && typeof value !== "number") {
+    return null;
+  }
+  if (typeof value === "string") {
+    const localDate = resolveLocalDateString(value);
+    if (localDate) {
+      return localDate;
+    }
+  }
+  const resolved = new Date(value);
+  return Number.isNaN(resolved.getTime()) ? null : resolved;
+}
+function isDateTimeFormatPattern(pattern) {
+  return DATE_TIME_FORMAT_TOKEN.test(pattern.replace(/\[[^\]]*\]/g, ""));
+}
+function formatDateTimeValue(value, pattern, locale = "zh-cn") {
+  const date = resolveDateValue(value);
+  const normalizedPattern = pattern.trim();
+  if (!date || !normalizedPattern) {
+    return null;
+  }
+  const year = date.getFullYear();
+  const monthIndex = date.getMonth();
+  const month = monthIndex + 1;
+  const day = date.getDate();
+  const weekdayIndex = date.getDay();
+  const hour = date.getHours();
+  const hour12 = hour % 12 || 12;
+  const minute = date.getMinutes();
+  const second = date.getSeconds();
+  const millisecond = date.getMilliseconds();
+  const chinese = locale.toLowerCase().startsWith("zh");
+  const marker = hour >= 12 ? chinese ? "\u4E0B\u5348" : "PM" : chinese ? "\u4E0A\u5348" : "AM";
+  const weekday = chinese ? ZH_WEEKDAYS[weekdayIndex] ?? "" : EN_WEEKDAYS[weekdayIndex] ?? "";
+  const weekdayShort = chinese ? ZH_WEEKDAYS_SHORT[weekdayIndex] ?? "" : weekday.slice(0, 3);
+  const monthName = chinese ? `${month}\u6708` : EN_MONTHS[monthIndex] ?? "";
+  const values = {
+    YYYY: String(year).padStart(4, "0"),
+    YY: String(year).slice(-2),
+    M: String(month),
+    MM: padNumber(month),
+    MMM: chinese ? monthName : monthName.slice(0, 3),
+    MMMM: monthName,
+    D: String(day),
+    DD: padNumber(day),
+    d: String(weekdayIndex),
+    dd: chinese ? weekdayShort.slice(-1) : weekday.slice(0, 2),
+    ddd: weekdayShort,
+    dddd: weekday,
+    H: String(hour),
+    HH: padNumber(hour),
+    h: String(hour12),
+    hh: padNumber(hour12),
+    m: String(minute),
+    mm: padNumber(minute),
+    s: String(second),
+    ss: padNumber(second),
+    S: String(Math.floor(millisecond / 100)),
+    SS: String(Math.floor(millisecond / 10)).padStart(2, "0"),
+    SSS: String(millisecond).padStart(3, "0"),
+    A: marker,
+    a: marker.toLowerCase()
+  };
+  return normalizedPattern.replace(
+    FORMAT_TOKEN,
+    (token) => token.startsWith("[") && token.endsWith("]") ? token.slice(1, -1) : values[token] ?? token
+  );
+}
+function padNumber(value) {
+  return String(value).padStart(2, "0");
+}
+function resolveLocalDateString(value) {
+  const match = value.trim().match(
+    /^(\d{4})[-/](\d{1,2})[-/](\d{1,2})(?:[ T](\d{1,2}):?(\d{2})?(?::?(\d{2}))?(?:\.(\d{1,3}))?)?$/
+  );
+  if (!match) {
+    return null;
+  }
+  const [
+    ,
+    yearText,
+    monthText,
+    dayText,
+    hourText,
+    minuteText,
+    secondText,
+    millisecondText
+  ] = match;
+  const year = Number(yearText);
+  const monthIndex = Number(monthText) - 1;
+  const day = Number(dayText);
+  const hour = Number(hourText ?? 0);
+  const minute = Number(minuteText ?? 0);
+  const second = Number(secondText ?? 0);
+  const millisecond = Number((millisecondText ?? "0").padEnd(3, "0"));
+  const resolved = new Date(
+    year,
+    monthIndex,
+    day,
+    hour,
+    minute,
+    second,
+    millisecond
+  );
+  return resolved.getFullYear() === year && resolved.getMonth() === monthIndex && resolved.getDate() === day && resolved.getHours() === hour && resolved.getMinutes() === minute && resolved.getSeconds() === second ? resolved : null;
+}
+
+exports.formatDateTimeValue = formatDateTimeValue;
+exports.isDateTimeFormatPattern = isDateTimeFormatPattern;
+exports.resolveDateValue = resolveDateValue;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/date/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/date/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/** Day.js 风格日期时间格式中支持识别的 token。 */\nconst DATE_TIME_FORMAT_TOKEN =\n  /Y{2,4}|M{1,4}|D{1,2}|d{1,4}|H{1,2}|h{1,2}|m{1,2}|s{1,2}|S{1,3}|A|a/;\n\nconst FORMAT_TOKEN =\n  /\\[[^\\]]*\\]|YYYY|MMMM|MMM|dddd|ddd|SSS|YY|MM|DD|dd|HH|hh|mm|ss|SS|M|D|d|H|h|m|s|S|A|a/g;\n\nconst ZH_WEEKDAYS = [\n  \"星期日\",\n  \"星期一\",\n  \"星期二\",\n  \"星期三\",\n  \"星期四\",\n  \"星期五\",\n  \"星期六\",\n];\nconst ZH_WEEKDAYS_SHORT = [\n  \"周日\",\n  \"周一\",\n  \"周二\",\n  \"周三\",\n  \"周四\",\n  \"周五\",\n  \"周六\",\n];\nconst EN_WEEKDAYS = [\n  \"Sunday\",\n  \"Monday\",\n  \"Tuesday\",\n  \"Wednesday\",\n  \"Thursday\",\n  \"Friday\",\n  \"Saturday\",\n];\nconst EN_MONTHS = [\n  \"January\",\n  \"February\",\n  \"March\",\n  \"April\",\n  \"May\",\n  \"June\",\n  \"July\",\n  \"August\",\n  \"September\",\n  \"October\",\n  \"November\",\n  \"December\",\n];\n\n/** 将未知值解析为有效日期。 */\nexport function resolveDateValue(value: unknown): Date | null {\n  if (value instanceof Date) {\n    return Number.isNaN(value.getTime()) ? null : value;\n  }\n  if (typeof value !== \"string\" && typeof value !== \"number\") {\n    return null;\n  }\n  if (typeof value === \"string\") {\n    const localDate = resolveLocalDateString(value);\n    if (localDate) {\n      return localDate;\n    }\n  }\n  const resolved = new Date(value);\n  return Number.isNaN(resolved.getTime()) ? null : resolved;\n}\n\n/** 判断字符串中是否包含 Day.js 风格的日期时间格式 token。 */\nexport function isDateTimeFormatPattern(pattern: string) {\n  return DATE_TIME_FORMAT_TOKEN.test(pattern.replace(/\\[[^\\]]*\\]/g, \"\"));\n}\n\n/**\n * 使用 Day.js 风格的常用 token 格式化日期时间，不依赖 Day.js 运行时。\n *\n * 支持年、月、日、星期、24/12 小时、分、秒、毫秒和上下午标记；\n * 默认使用中文区域设置，值或 pattern 无效时返回 `null`。\n */\nexport function formatDateTimeValue(\n  value: unknown,\n  pattern: string,\n  locale = \"zh-cn\",\n): string | null {\n  const date = resolveDateValue(value);\n  const normalizedPattern = pattern.trim();\n  if (!date || !normalizedPattern) {\n    return null;\n  }\n  const year = date.getFullYear();\n  const monthIndex = date.getMonth();\n  const month = monthIndex + 1;\n  const day = date.getDate();\n  const weekdayIndex = date.getDay();\n  const hour = date.getHours();\n  const hour12 = hour % 12 || 12;\n  const minute = date.getMinutes();\n  const second = date.getSeconds();\n  const millisecond = date.getMilliseconds();\n  const chinese = locale.toLowerCase().startsWith(\"zh\");\n  const marker =\n    hour >= 12 ? (chinese ? \"下午\" : \"PM\") : chinese ? \"上午\" : \"AM\";\n  const weekday = chinese\n    ? (ZH_WEEKDAYS[weekdayIndex] ?? \"\")\n    : (EN_WEEKDAYS[weekdayIndex] ?? \"\");\n  const weekdayShort = chinese\n    ? (ZH_WEEKDAYS_SHORT[weekdayIndex] ?? \"\")\n    : weekday.slice(0, 3);\n  const monthName = chinese ? `${month}月` : (EN_MONTHS[monthIndex] ?? \"\");\n  const values: Record<string, string> = {\n    YYYY: String(year).padStart(4, \"0\"),\n    YY: String(year).slice(-2),\n    M: String(month),\n    MM: padNumber(month),\n    MMM: chinese ? monthName : monthName.slice(0, 3),\n    MMMM: monthName,\n    D: String(day),\n    DD: padNumber(day),\n    d: String(weekdayIndex),\n    dd: chinese ? weekdayShort.slice(-1) : weekday.slice(0, 2),\n    ddd: weekdayShort,\n    dddd: weekday,\n    H: String(hour),\n    HH: padNumber(hour),\n    h: String(hour12),\n    hh: padNumber(hour12),\n    m: String(minute),\n    mm: padNumber(minute),\n    s: String(second),\n    ss: padNumber(second),\n    S: String(Math.floor(millisecond / 100)),\n    SS: String(Math.floor(millisecond / 10)).padStart(2, \"0\"),\n    SSS: String(millisecond).padStart(3, \"0\"),\n    A: marker,\n    a: marker.toLowerCase(),\n  };\n\n  return normalizedPattern.replace(FORMAT_TOKEN, (token) =>\n    token.startsWith(\"[\") && token.endsWith(\"]\")\n      ? token.slice(1, -1)\n      : (values[token] ?? token),\n  );\n}\n\nfunction padNumber(value: number) {\n  return String(value).padStart(2, \"0\");\n}\n\nfunction resolveLocalDateString(value: string) {\n  const match = value\n    .trim()\n    .match(\n      /^(\\d{4})[-/](\\d{1,2})[-/](\\d{1,2})(?:[ T](\\d{1,2}):?(\\d{2})?(?::?(\\d{2}))?(?:\\.(\\d{1,3}))?)?$/,\n    );\n  if (!match) {\n    return null;\n  }\n  const [\n    ,\n    yearText,\n    monthText,\n    dayText,\n    hourText,\n    minuteText,\n    secondText,\n    millisecondText,\n  ] = match;\n  const year = Number(yearText);\n  const monthIndex = Number(monthText) - 1;\n  const day = Number(dayText);\n  const hour = Number(hourText ?? 0);\n  const minute = Number(minuteText ?? 0);\n  const second = Number(secondText ?? 0);\n  const millisecond = Number((millisecondText ?? \"0\").padEnd(3, \"0\"));\n  const resolved = new Date(\n    year,\n    monthIndex,\n    day,\n    hour,\n    minute,\n    second,\n    millisecond,\n  );\n  return resolved.getFullYear() === year &&\n    resolved.getMonth() === monthIndex &&\n    resolved.getDate() === day &&\n    resolved.getHours() === hour &&\n    resolved.getMinutes() === minute &&\n    resolved.getSeconds() === second\n    ? resolved\n    : null;\n}\n"]}

package/dist/date/index.d.cts

@@ -0,0 +1,13 @@
+/** 将未知值解析为有效日期。 */
+declare function resolveDateValue(value: unknown): Date | null;
+/** 判断字符串中是否包含 Day.js 风格的日期时间格式 token。 */
+declare function isDateTimeFormatPattern(pattern: string): boolean;
+/**
+ * 使用 Day.js 风格的常用 token 格式化日期时间，不依赖 Day.js 运行时。
+ *
+ * 支持年、月、日、星期、24/12 小时、分、秒、毫秒和上下午标记；
+ * 默认使用中文区域设置，值或 pattern 无效时返回 `null`。
+ */
+declare function formatDateTimeValue(value: unknown, pattern: string, locale?: string): string | null;
+
+export { formatDateTimeValue, isDateTimeFormatPattern, resolveDateValue };

package/dist/date/index.d.ts

@@ -0,0 +1,13 @@
+/** 将未知值解析为有效日期。 */
+declare function resolveDateValue(value: unknown): Date | null;
+/** 判断字符串中是否包含 Day.js 风格的日期时间格式 token。 */
+declare function isDateTimeFormatPattern(pattern: string): boolean;
+/**
+ * 使用 Day.js 风格的常用 token 格式化日期时间，不依赖 Day.js 运行时。
+ *
+ * 支持年、月、日、星期、24/12 小时、分、秒、毫秒和上下午标记；
+ * 默认使用中文区域设置，值或 pattern 无效时返回 `null`。
+ */
+declare function formatDateTimeValue(value: unknown, pattern: string, locale?: string): string | null;
+
+export { formatDateTimeValue, isDateTimeFormatPattern, resolveDateValue };

package/dist/date/index.js

@@ -0,0 +1,158 @@
+// src/date/index.ts
+var DATE_TIME_FORMAT_TOKEN = /Y{2,4}|M{1,4}|D{1,2}|d{1,4}|H{1,2}|h{1,2}|m{1,2}|s{1,2}|S{1,3}|A|a/;
+var FORMAT_TOKEN = /\[[^\]]*\]|YYYY|MMMM|MMM|dddd|ddd|SSS|YY|MM|DD|dd|HH|hh|mm|ss|SS|M|D|d|H|h|m|s|S|A|a/g;
+var ZH_WEEKDAYS = [
+  "\u661F\u671F\u65E5",
+  "\u661F\u671F\u4E00",
+  "\u661F\u671F\u4E8C",
+  "\u661F\u671F\u4E09",
+  "\u661F\u671F\u56DB",
+  "\u661F\u671F\u4E94",
+  "\u661F\u671F\u516D"
+];
+var ZH_WEEKDAYS_SHORT = [
+  "\u5468\u65E5",
+  "\u5468\u4E00",
+  "\u5468\u4E8C",
+  "\u5468\u4E09",
+  "\u5468\u56DB",
+  "\u5468\u4E94",
+  "\u5468\u516D"
+];
+var EN_WEEKDAYS = [
+  "Sunday",
+  "Monday",
+  "Tuesday",
+  "Wednesday",
+  "Thursday",
+  "Friday",
+  "Saturday"
+];
+var EN_MONTHS = [
+  "January",
+  "February",
+  "March",
+  "April",
+  "May",
+  "June",
+  "July",
+  "August",
+  "September",
+  "October",
+  "November",
+  "December"
+];
+function resolveDateValue(value) {
+  if (value instanceof Date) {
+    return Number.isNaN(value.getTime()) ? null : value;
+  }
+  if (typeof value !== "string" && typeof value !== "number") {
+    return null;
+  }
+  if (typeof value === "string") {
+    const localDate = resolveLocalDateString(value);
+    if (localDate) {
+      return localDate;
+    }
+  }
+  const resolved = new Date(value);
+  return Number.isNaN(resolved.getTime()) ? null : resolved;
+}
+function isDateTimeFormatPattern(pattern) {
+  return DATE_TIME_FORMAT_TOKEN.test(pattern.replace(/\[[^\]]*\]/g, ""));
+}
+function formatDateTimeValue(value, pattern, locale = "zh-cn") {
+  const date = resolveDateValue(value);
+  const normalizedPattern = pattern.trim();
+  if (!date || !normalizedPattern) {
+    return null;
+  }
+  const year = date.getFullYear();
+  const monthIndex = date.getMonth();
+  const month = monthIndex + 1;
+  const day = date.getDate();
+  const weekdayIndex = date.getDay();
+  const hour = date.getHours();
+  const hour12 = hour % 12 || 12;
+  const minute = date.getMinutes();
+  const second = date.getSeconds();
+  const millisecond = date.getMilliseconds();
+  const chinese = locale.toLowerCase().startsWith("zh");
+  const marker = hour >= 12 ? chinese ? "\u4E0B\u5348" : "PM" : chinese ? "\u4E0A\u5348" : "AM";
+  const weekday = chinese ? ZH_WEEKDAYS[weekdayIndex] ?? "" : EN_WEEKDAYS[weekdayIndex] ?? "";
+  const weekdayShort = chinese ? ZH_WEEKDAYS_SHORT[weekdayIndex] ?? "" : weekday.slice(0, 3);
+  const monthName = chinese ? `${month}\u6708` : EN_MONTHS[monthIndex] ?? "";
+  const values = {
+    YYYY: String(year).padStart(4, "0"),
+    YY: String(year).slice(-2),
+    M: String(month),
+    MM: padNumber(month),
+    MMM: chinese ? monthName : monthName.slice(0, 3),
+    MMMM: monthName,
+    D: String(day),
+    DD: padNumber(day),
+    d: String(weekdayIndex),
+    dd: chinese ? weekdayShort.slice(-1) : weekday.slice(0, 2),
+    ddd: weekdayShort,
+    dddd: weekday,
+    H: String(hour),
+    HH: padNumber(hour),
+    h: String(hour12),
+    hh: padNumber(hour12),
+    m: String(minute),
+    mm: padNumber(minute),
+    s: String(second),
+    ss: padNumber(second),
+    S: String(Math.floor(millisecond / 100)),
+    SS: String(Math.floor(millisecond / 10)).padStart(2, "0"),
+    SSS: String(millisecond).padStart(3, "0"),
+    A: marker,
+    a: marker.toLowerCase()
+  };
+  return normalizedPattern.replace(
+    FORMAT_TOKEN,
+    (token) => token.startsWith("[") && token.endsWith("]") ? token.slice(1, -1) : values[token] ?? token
+  );
+}
+function padNumber(value) {
+  return String(value).padStart(2, "0");
+}
+function resolveLocalDateString(value) {
+  const match = value.trim().match(
+    /^(\d{4})[-/](\d{1,2})[-/](\d{1,2})(?:[ T](\d{1,2}):?(\d{2})?(?::?(\d{2}))?(?:\.(\d{1,3}))?)?$/
+  );
+  if (!match) {
+    return null;
+  }
+  const [
+    ,
+    yearText,
+    monthText,
+    dayText,
+    hourText,
+    minuteText,
+    secondText,
+    millisecondText
+  ] = match;
+  const year = Number(yearText);
+  const monthIndex = Number(monthText) - 1;
+  const day = Number(dayText);
+  const hour = Number(hourText ?? 0);
+  const minute = Number(minuteText ?? 0);
+  const second = Number(secondText ?? 0);
+  const millisecond = Number((millisecondText ?? "0").padEnd(3, "0"));
+  const resolved = new Date(
+    year,
+    monthIndex,
+    day,
+    hour,
+    minute,
+    second,
+    millisecond
+  );
+  return resolved.getFullYear() === year && resolved.getMonth() === monthIndex && resolved.getDate() === day && resolved.getHours() === hour && resolved.getMinutes() === minute && resolved.getSeconds() === second ? resolved : null;
+}
+
+export { formatDateTimeValue, isDateTimeFormatPattern, resolveDateValue };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/date/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/date/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/** Day.js 风格日期时间格式中支持识别的 token。 */\nconst DATE_TIME_FORMAT_TOKEN =\n  /Y{2,4}|M{1,4}|D{1,2}|d{1,4}|H{1,2}|h{1,2}|m{1,2}|s{1,2}|S{1,3}|A|a/;\n\nconst FORMAT_TOKEN =\n  /\\[[^\\]]*\\]|YYYY|MMMM|MMM|dddd|ddd|SSS|YY|MM|DD|dd|HH|hh|mm|ss|SS|M|D|d|H|h|m|s|S|A|a/g;\n\nconst ZH_WEEKDAYS = [\n  \"星期日\",\n  \"星期一\",\n  \"星期二\",\n  \"星期三\",\n  \"星期四\",\n  \"星期五\",\n  \"星期六\",\n];\nconst ZH_WEEKDAYS_SHORT = [\n  \"周日\",\n  \"周一\",\n  \"周二\",\n  \"周三\",\n  \"周四\",\n  \"周五\",\n  \"周六\",\n];\nconst EN_WEEKDAYS = [\n  \"Sunday\",\n  \"Monday\",\n  \"Tuesday\",\n  \"Wednesday\",\n  \"Thursday\",\n  \"Friday\",\n  \"Saturday\",\n];\nconst EN_MONTHS = [\n  \"January\",\n  \"February\",\n  \"March\",\n  \"April\",\n  \"May\",\n  \"June\",\n  \"July\",\n  \"August\",\n  \"September\",\n  \"October\",\n  \"November\",\n  \"December\",\n];\n\n/** 将未知值解析为有效日期。 */\nexport function resolveDateValue(value: unknown): Date | null {\n  if (value instanceof Date) {\n    return Number.isNaN(value.getTime()) ? null : value;\n  }\n  if (typeof value !== \"string\" && typeof value !== \"number\") {\n    return null;\n  }\n  if (typeof value === \"string\") {\n    const localDate = resolveLocalDateString(value);\n    if (localDate) {\n      return localDate;\n    }\n  }\n  const resolved = new Date(value);\n  return Number.isNaN(resolved.getTime()) ? null : resolved;\n}\n\n/** 判断字符串中是否包含 Day.js 风格的日期时间格式 token。 */\nexport function isDateTimeFormatPattern(pattern: string) {\n  return DATE_TIME_FORMAT_TOKEN.test(pattern.replace(/\\[[^\\]]*\\]/g, \"\"));\n}\n\n/**\n * 使用 Day.js 风格的常用 token 格式化日期时间，不依赖 Day.js 运行时。\n *\n * 支持年、月、日、星期、24/12 小时、分、秒、毫秒和上下午标记；\n * 默认使用中文区域设置，值或 pattern 无效时返回 `null`。\n */\nexport function formatDateTimeValue(\n  value: unknown,\n  pattern: string,\n  locale = \"zh-cn\",\n): string | null {\n  const date = resolveDateValue(value);\n  const normalizedPattern = pattern.trim();\n  if (!date || !normalizedPattern) {\n    return null;\n  }\n  const year = date.getFullYear();\n  const monthIndex = date.getMonth();\n  const month = monthIndex + 1;\n  const day = date.getDate();\n  const weekdayIndex = date.getDay();\n  const hour = date.getHours();\n  const hour12 = hour % 12 || 12;\n  const minute = date.getMinutes();\n  const second = date.getSeconds();\n  const millisecond = date.getMilliseconds();\n  const chinese = locale.toLowerCase().startsWith(\"zh\");\n  const marker =\n    hour >= 12 ? (chinese ? \"下午\" : \"PM\") : chinese ? \"上午\" : \"AM\";\n  const weekday = chinese\n    ? (ZH_WEEKDAYS[weekdayIndex] ?? \"\")\n    : (EN_WEEKDAYS[weekdayIndex] ?? \"\");\n  const weekdayShort = chinese\n    ? (ZH_WEEKDAYS_SHORT[weekdayIndex] ?? \"\")\n    : weekday.slice(0, 3);\n  const monthName = chinese ? `${month}月` : (EN_MONTHS[monthIndex] ?? \"\");\n  const values: Record<string, string> = {\n    YYYY: String(year).padStart(4, \"0\"),\n    YY: String(year).slice(-2),\n    M: String(month),\n    MM: padNumber(month),\n    MMM: chinese ? monthName : monthName.slice(0, 3),\n    MMMM: monthName,\n    D: String(day),\n    DD: padNumber(day),\n    d: String(weekdayIndex),\n    dd: chinese ? weekdayShort.slice(-1) : weekday.slice(0, 2),\n    ddd: weekdayShort,\n    dddd: weekday,\n    H: String(hour),\n    HH: padNumber(hour),\n    h: String(hour12),\n    hh: padNumber(hour12),\n    m: String(minute),\n    mm: padNumber(minute),\n    s: String(second),\n    ss: padNumber(second),\n    S: String(Math.floor(millisecond / 100)),\n    SS: String(Math.floor(millisecond / 10)).padStart(2, \"0\"),\n    SSS: String(millisecond).padStart(3, \"0\"),\n    A: marker,\n    a: marker.toLowerCase(),\n  };\n\n  return normalizedPattern.replace(FORMAT_TOKEN, (token) =>\n    token.startsWith(\"[\") && token.endsWith(\"]\")\n      ? token.slice(1, -1)\n      : (values[token] ?? token),\n  );\n}\n\nfunction padNumber(value: number) {\n  return String(value).padStart(2, \"0\");\n}\n\nfunction resolveLocalDateString(value: string) {\n  const match = value\n    .trim()\n    .match(\n      /^(\\d{4})[-/](\\d{1,2})[-/](\\d{1,2})(?:[ T](\\d{1,2}):?(\\d{2})?(?::?(\\d{2}))?(?:\\.(\\d{1,3}))?)?$/,\n    );\n  if (!match) {\n    return null;\n  }\n  const [\n    ,\n    yearText,\n    monthText,\n    dayText,\n    hourText,\n    minuteText,\n    secondText,\n    millisecondText,\n  ] = match;\n  const year = Number(yearText);\n  const monthIndex = Number(monthText) - 1;\n  const day = Number(dayText);\n  const hour = Number(hourText ?? 0);\n  const minute = Number(minuteText ?? 0);\n  const second = Number(secondText ?? 0);\n  const millisecond = Number((millisecondText ?? \"0\").padEnd(3, \"0\"));\n  const resolved = new Date(\n    year,\n    monthIndex,\n    day,\n    hour,\n    minute,\n    second,\n    millisecond,\n  );\n  return resolved.getFullYear() === year &&\n    resolved.getMonth() === monthIndex &&\n    resolved.getDate() === day &&\n    resolved.getHours() === hour &&\n    resolved.getMinutes() === minute &&\n    resolved.getSeconds() === second\n    ? resolved\n    : null;\n}\n"]}