@planarcat/js-toolkit 1.7.22 → 1.7.28
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +8 -1
- package/dist/date/formatDateCompiled.d.ts +0 -30
- package/dist/date/formatDateCompiled.d.ts.map +0 -1
- package/dist/date/formatDateCompiled.js +0 -126
- package/dist/date/formatDateCompiled.js.map +0 -1
- package/dist/date/formatDatePlain.d.ts +0 -34
- package/dist/date/formatDatePlain.d.ts.map +0 -1
- package/dist/date/formatDatePlain.js +0 -128
- package/dist/date/formatDatePlain.js.map +0 -1
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@planarcat/js-toolkit",
|
|
3
|
-
"version": "1.7.
|
|
3
|
+
"version": "1.7.28",
|
|
4
4
|
"description": "一个现代化的 JavaScript/TypeScript 实用工具库,提供类型安全、高性能的常用函数,包括对象转换、日期处理、函数优化等开发常用工具。",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
@@ -50,6 +50,12 @@
|
|
|
50
50
|
},
|
|
51
51
|
"homepage": "https://github.com/planarcat/js-toolkit#readme",
|
|
52
52
|
"devDependencies": {
|
|
53
|
+
"@semantic-release/changelog": "^6.0.3",
|
|
54
|
+
"@semantic-release/commit-analyzer": "^13.0.1",
|
|
55
|
+
"@semantic-release/git": "^10.0.1",
|
|
56
|
+
"@semantic-release/github": "^12.0.2",
|
|
57
|
+
"@semantic-release/npm": "^13.1.3",
|
|
58
|
+
"@semantic-release/release-notes-generator": "^14.1.0",
|
|
53
59
|
"@types/jest": "^29.5.14",
|
|
54
60
|
"@types/node": "^25.0.7",
|
|
55
61
|
"@typescript-eslint/eslint-plugin": "^6.21.0",
|
|
@@ -62,6 +68,7 @@
|
|
|
62
68
|
"lint-staged": "^13.3.0",
|
|
63
69
|
"prettier": "^3.7.4",
|
|
64
70
|
"rimraf": "^5.0.10",
|
|
71
|
+
"semantic-release": "^25.0.2",
|
|
65
72
|
"ts-jest": "^29.4.6",
|
|
66
73
|
"ts-node": "^10.9.2",
|
|
67
74
|
"ts-node-dev": "^2.0.0",
|
|
@@ -1,30 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* 编译模式日期格式化实现
|
|
3
|
-
* 首次调用编译格式化字符串,后续调用使用缓存的编译函数
|
|
4
|
-
*/
|
|
5
|
-
import { DateFormatOptions, DateInput } from '../types/date';
|
|
6
|
-
/**
|
|
7
|
-
* 编译后的格式化函数类型
|
|
8
|
-
*/
|
|
9
|
-
type CompiledFormatter = (date: Date, options: DateFormatOptions) => string;
|
|
10
|
-
/**
|
|
11
|
-
* 编译格式化字符串,生成优化的格式化函数
|
|
12
|
-
* @param formatStr - 格式化字符串
|
|
13
|
-
* @returns 编译后的格式化函数
|
|
14
|
-
*/
|
|
15
|
-
export declare function compileFormat(formatStr: string): CompiledFormatter;
|
|
16
|
-
/**
|
|
17
|
-
* 清除格式化缓存
|
|
18
|
-
* @param formatStr - 可选,指定要清除的格式化字符串缓存
|
|
19
|
-
*/
|
|
20
|
-
export declare function clearFormatCache(formatStr?: string): void;
|
|
21
|
-
/**
|
|
22
|
-
* 编译模式日期格式化
|
|
23
|
-
* @param input - 要格式化的日期输入
|
|
24
|
-
* @param formatStr - 格式化字符串
|
|
25
|
-
* @param options - 格式化选项
|
|
26
|
-
* @returns 格式化后的日期字符串
|
|
27
|
-
*/
|
|
28
|
-
export declare function formatDateCompiled(input: DateInput, formatStr?: string, options?: Partial<DateFormatOptions>): string;
|
|
29
|
-
export default formatDateCompiled;
|
|
30
|
-
//# sourceMappingURL=formatDateCompiled.d.ts.map
|
|
@@ -1 +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"}
|
|
@@ -1,126 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.formatDateCompiled = exports.clearFormatCache = exports.compileFormat = void 0;
|
|
4
|
-
const constants_1 = require("../utils/constants");
|
|
5
|
-
const formatDatePlain_1 = require("./formatDatePlain");
|
|
6
|
-
/**
|
|
7
|
-
* 格式化缓存,用于存储编译后的格式化函数
|
|
8
|
-
*/
|
|
9
|
-
const FORMAT_CACHE = new Map();
|
|
10
|
-
/**
|
|
11
|
-
* 编译格式化字符串,生成优化的格式化函数
|
|
12
|
-
* @param formatStr - 格式化字符串
|
|
13
|
-
* @returns 编译后的格式化函数
|
|
14
|
-
*/
|
|
15
|
-
function compileFormat(formatStr) {
|
|
16
|
-
// 检查缓存
|
|
17
|
-
if (FORMAT_CACHE.has(formatStr)) {
|
|
18
|
-
return FORMAT_CACHE.get(formatStr);
|
|
19
|
-
}
|
|
20
|
-
// 生成编译后的函数
|
|
21
|
-
const compiledFn = (date, options) => {
|
|
22
|
-
// 获取日期各部分
|
|
23
|
-
const year = date.getFullYear();
|
|
24
|
-
const month = date.getMonth() + 1;
|
|
25
|
-
const day = date.getDate();
|
|
26
|
-
const hours = date.getHours();
|
|
27
|
-
const minutes = date.getMinutes();
|
|
28
|
-
const seconds = date.getSeconds();
|
|
29
|
-
const milliseconds = date.getMilliseconds();
|
|
30
|
-
const weekday = date.getDay();
|
|
31
|
-
const quarter = Math.floor((date.getMonth() + 3) / 3);
|
|
32
|
-
const weekNumber = (0, formatDatePlain_1.getWeekNumber)(date);
|
|
33
|
-
// 12小时制
|
|
34
|
-
const hours12 = hours % 12 || 12;
|
|
35
|
-
const ampm = hours < 12 ? 'AM' : 'PM';
|
|
36
|
-
const ampmLower = ampm.toLowerCase();
|
|
37
|
-
let result = formatStr;
|
|
38
|
-
// 优先替换 timestamp,避免被拆解
|
|
39
|
-
if (result.includes('timestamp')) {
|
|
40
|
-
result = result.replace(/timestamp/g, date.getTime().toString());
|
|
41
|
-
}
|
|
42
|
-
// 2. 应用自定义格式化器(优先级最高)
|
|
43
|
-
if (options.customFormatters) {
|
|
44
|
-
Object.entries(options.customFormatters).forEach(([token, formatter]) => {
|
|
45
|
-
const escapedToken = token.replace(/[.*+?^${}()|[\\]/g, '\\$&');
|
|
46
|
-
const regex = new RegExp(`(?<![a-zA-Z0-9])${escapedToken}(?![a-zA-Z0-9])`, 'g');
|
|
47
|
-
result = result.replace(regex, formatter(date));
|
|
48
|
-
});
|
|
49
|
-
}
|
|
50
|
-
// 3. 替换多字符标记(2-4个字符)
|
|
51
|
-
const multiCharReplacements = {
|
|
52
|
-
YYYY: year.toString().padStart(4, '0'),
|
|
53
|
-
YY: year.toString().slice(-2),
|
|
54
|
-
MM: month.toString().padStart(2, '0'),
|
|
55
|
-
DD: day.toString().padStart(2, '0'),
|
|
56
|
-
HH: hours.toString().padStart(2, '0'),
|
|
57
|
-
hh: hours12.toString().padStart(2, '0'),
|
|
58
|
-
mm: minutes.toString().padStart(2, '0'),
|
|
59
|
-
ss: seconds.toString().padStart(2, '0'),
|
|
60
|
-
SSS: milliseconds.toString().padStart(3, '0'),
|
|
61
|
-
WW: weekNumber.toString().padStart(2, '0'),
|
|
62
|
-
dd: (0, formatDatePlain_1.getLocalizedWeekday)(weekday, options),
|
|
63
|
-
};
|
|
64
|
-
Object.entries(multiCharReplacements).forEach(([token, value]) => {
|
|
65
|
-
// 使用单词边界或字符串边界来确保精确匹配
|
|
66
|
-
const regex = new RegExp(`\\b${token}\\b|${token}(?![a-zA-Z0-9])`, 'g');
|
|
67
|
-
result = result.replace(regex, value);
|
|
68
|
-
});
|
|
69
|
-
// 4. 替换单字符标记(使用更精确的匹配)
|
|
70
|
-
const singleCharReplacements = {
|
|
71
|
-
Y: year.toString(),
|
|
72
|
-
M: month.toString(),
|
|
73
|
-
D: day.toString(),
|
|
74
|
-
H: hours.toString(),
|
|
75
|
-
h: hours12.toString(),
|
|
76
|
-
m: minutes.toString(),
|
|
77
|
-
s: seconds.toString(),
|
|
78
|
-
W: weekNumber.toString(),
|
|
79
|
-
d: weekday.toString(),
|
|
80
|
-
Q: quarter.toString(),
|
|
81
|
-
A: ampm,
|
|
82
|
-
a: ampmLower,
|
|
83
|
-
};
|
|
84
|
-
Object.entries(singleCharReplacements).forEach(([token, value]) => {
|
|
85
|
-
// 单字符需要更精确的匹配:前面是边界或特定字符,后面不是相同字符
|
|
86
|
-
const regex = new RegExp(`(?<![a-zA-Z0-9])${token}(?![a-zA-Z0-9])`, 'g');
|
|
87
|
-
result = result.replace(regex, value);
|
|
88
|
-
});
|
|
89
|
-
return result;
|
|
90
|
-
};
|
|
91
|
-
// 缓存编译结果
|
|
92
|
-
FORMAT_CACHE.set(formatStr, compiledFn);
|
|
93
|
-
return compiledFn;
|
|
94
|
-
}
|
|
95
|
-
exports.compileFormat = compileFormat;
|
|
96
|
-
/**
|
|
97
|
-
* 清除格式化缓存
|
|
98
|
-
* @param formatStr - 可选,指定要清除的格式化字符串缓存
|
|
99
|
-
*/
|
|
100
|
-
function clearFormatCache(formatStr) {
|
|
101
|
-
if (formatStr) {
|
|
102
|
-
FORMAT_CACHE.delete(formatStr);
|
|
103
|
-
}
|
|
104
|
-
else {
|
|
105
|
-
FORMAT_CACHE.clear();
|
|
106
|
-
}
|
|
107
|
-
}
|
|
108
|
-
exports.clearFormatCache = clearFormatCache;
|
|
109
|
-
/**
|
|
110
|
-
* 编译模式日期格式化
|
|
111
|
-
* @param input - 要格式化的日期输入
|
|
112
|
-
* @param formatStr - 格式化字符串
|
|
113
|
-
* @param options - 格式化选项
|
|
114
|
-
* @returns 格式化后的日期字符串
|
|
115
|
-
*/
|
|
116
|
-
function formatDateCompiled(input, formatStr = 'YYYY-MM-DD HH:mm:ss', options = {}) {
|
|
117
|
-
const date = (0, formatDatePlain_1.safeParseDate)(input);
|
|
118
|
-
const mergedOptions = { ...constants_1.DEFAULT_DATE_FORMAT_OPTIONS, ...options };
|
|
119
|
-
// 编译并缓存格式化函数
|
|
120
|
-
const formatter = compileFormat(formatStr);
|
|
121
|
-
// 使用编译后的函数格式化日期
|
|
122
|
-
return formatter(date, mergedOptions);
|
|
123
|
-
}
|
|
124
|
-
exports.formatDateCompiled = formatDateCompiled;
|
|
125
|
-
exports.default = formatDateCompiled;
|
|
126
|
-
//# sourceMappingURL=formatDateCompiled.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"formatDateCompiled.js","sourceRoot":"","sources":["../../src/date/formatDateCompiled.ts"],"names":[],"mappings":";;;AAKA,kDAAiE;AACjE,uDAAsF;AAOtF;;GAEG;AACH,MAAM,YAAY,GAAG,IAAI,GAAG,EAA6B,CAAC;AAE1D;;;;GAIG;AACH,SAAgB,aAAa,CAAC,SAAiB;IAC3C,OAAO;IACP,IAAI,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,YAAY,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;IACxC,CAAC;IAED,WAAW;IACX,MAAM,UAAU,GAAsB,CAAC,IAAU,EAAE,OAA0B,EAAE,EAAE;QAC7E,UAAU;QACV,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,IAAA,+BAAa,EAAC,IAAI,CAAC,CAAC;QAEvC,QAAQ;QACR,MAAM,OAAO,GAAG,KAAK,GAAG,EAAE,IAAI,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACtC,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAErC,IAAI,MAAM,GAAG,SAAS,CAAC;QAEvB,uBAAuB;QACvB,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/B,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,sBAAsB;QACtB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC3B,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE;gBACpE,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;gBAChE,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,mBAAmB,YAAY,iBAAiB,EAAE,GAAG,CAAC,CAAC;gBAChF,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YACpD,CAAC,CAAC,CAAC;QACP,CAAC;QAED,qBAAqB;QACrB,MAAM,qBAAqB,GAA2B;YAClD,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;YACtC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC7B,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;YACrC,EAAE,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;YACnC,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;YACrC,EAAE,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;YACvC,EAAE,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;YACvC,EAAE,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;YACvC,GAAG,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;YAC7C,EAAE,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;YAC1C,EAAE,EAAE,IAAA,qCAAmB,EAAC,OAAO,EAAE,OAAO,CAAC;SAC5C,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE;YAC7D,sBAAsB;YACtB,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,KAAK,iBAAiB,EAAE,GAAG,CAAC,CAAC;YACxE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,uBAAuB;QACvB,MAAM,sBAAsB,GAA2B;YACnD,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE;YAClB,CAAC,EAAE,KAAK,CAAC,QAAQ,EAAE;YACnB,CAAC,EAAE,GAAG,CAAC,QAAQ,EAAE;YACjB,CAAC,EAAE,KAAK,CAAC,QAAQ,EAAE;YACnB,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE;YACrB,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE;YACrB,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE;YACrB,CAAC,EAAE,UAAU,CAAC,QAAQ,EAAE;YACxB,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE;YACrB,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE;YACrB,CAAC,EAAE,IAAI;YACP,CAAC,EAAE,SAAS;SACf,CAAC;QAEF,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE;YAC9D,kCAAkC;YAClC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,mBAAmB,KAAK,iBAAiB,EAAE,GAAG,CAAC,CAAC;YACzE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;IAEF,SAAS;IACT,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACxC,OAAO,UAAU,CAAC;AACtB,CAAC;AA1FD,sCA0FC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,SAAkB;IAC/C,IAAI,SAAS,EAAE,CAAC;QACZ,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;SAAM,CAAC;QACJ,YAAY,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;AACL,CAAC;AAND,4CAMC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAC9B,KAAgB,EAChB,YAAoB,qBAAqB,EACzC,UAAsC,EAAE;IAExC,MAAM,IAAI,GAAG,IAAA,+BAAa,EAAC,KAAK,CAAC,CAAC;IAClC,MAAM,aAAa,GAAG,EAAE,GAAG,uCAA2B,EAAE,GAAG,OAAO,EAAE,CAAC;IAErE,aAAa;IACb,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAE3C,gBAAgB;IAChB,OAAO,SAAS,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;AAC1C,CAAC;AAbD,gDAaC;AAED,kBAAe,kBAAkB,CAAC"}
|
|
@@ -1,34 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* 普通模式日期格式化实现
|
|
3
|
-
* 每次调用都会重新解析格式化字符串
|
|
4
|
-
*/
|
|
5
|
-
import { DateFormatOptions, DateInput } from '../types/date';
|
|
6
|
-
/**
|
|
7
|
-
* 将各种输入类型安全地转换为 Date 对象
|
|
8
|
-
* @param input - 日期输入
|
|
9
|
-
* @returns 转换后的 Date 对象,无效输入返回当前时间
|
|
10
|
-
*/
|
|
11
|
-
export declare function safeParseDate(input: DateInput): Date;
|
|
12
|
-
/**
|
|
13
|
-
* 计算一年中的第几周 (ISO 8601)
|
|
14
|
-
* @param date - 日期对象
|
|
15
|
-
* @returns 周数
|
|
16
|
-
*/
|
|
17
|
-
export declare function getWeekNumber(date: Date): number;
|
|
18
|
-
/**
|
|
19
|
-
* 获取本地化的星期几
|
|
20
|
-
* @param weekday - 星期几 (0-6)
|
|
21
|
-
* @param options - 格式化选项
|
|
22
|
-
* @returns 本地化的星期几字符串
|
|
23
|
-
*/
|
|
24
|
-
export declare function getLocalizedWeekday(weekday: number, options: DateFormatOptions): string;
|
|
25
|
-
/**
|
|
26
|
-
* 普通模式日期格式化
|
|
27
|
-
* @param input - 要格式化的日期输入
|
|
28
|
-
* @param formatStr - 格式化字符串
|
|
29
|
-
* @param options - 格式化选项
|
|
30
|
-
* @returns 格式化后的日期字符串
|
|
31
|
-
*/
|
|
32
|
-
export declare function formatDatePlain(input: DateInput, formatStr?: string, options?: Partial<DateFormatOptions>): string;
|
|
33
|
-
export default formatDatePlain;
|
|
34
|
-
//# sourceMappingURL=formatDatePlain.d.ts.map
|
|
@@ -1 +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"}
|
|
@@ -1,128 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.formatDatePlain = exports.getLocalizedWeekday = exports.getWeekNumber = exports.safeParseDate = void 0;
|
|
4
|
-
const constants_1 = require("../utils/constants");
|
|
5
|
-
/**
|
|
6
|
-
* 将各种输入类型安全地转换为 Date 对象
|
|
7
|
-
* @param input - 日期输入
|
|
8
|
-
* @returns 转换后的 Date 对象,无效输入返回当前时间
|
|
9
|
-
*/
|
|
10
|
-
function safeParseDate(input) {
|
|
11
|
-
if (input instanceof Date && !isNaN(input.getTime())) {
|
|
12
|
-
return input;
|
|
13
|
-
}
|
|
14
|
-
if (typeof input === 'string' || typeof input === 'number') {
|
|
15
|
-
const date = new Date(input);
|
|
16
|
-
if (!isNaN(date.getTime())) {
|
|
17
|
-
return date;
|
|
18
|
-
}
|
|
19
|
-
}
|
|
20
|
-
// 无效输入返回当前时间
|
|
21
|
-
console.warn(`Invalid date input: ${input}, using current date instead.`);
|
|
22
|
-
return new Date();
|
|
23
|
-
}
|
|
24
|
-
exports.safeParseDate = safeParseDate;
|
|
25
|
-
/**
|
|
26
|
-
* 计算一年中的第几周 (ISO 8601)
|
|
27
|
-
* @param date - 日期对象
|
|
28
|
-
* @returns 周数
|
|
29
|
-
*/
|
|
30
|
-
function getWeekNumber(date) {
|
|
31
|
-
const d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
|
|
32
|
-
const dayNum = d.getUTCDay() || 7;
|
|
33
|
-
d.setUTCDate(d.getUTCDate() + 4 - dayNum);
|
|
34
|
-
const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
|
|
35
|
-
return Math.ceil(((d.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);
|
|
36
|
-
}
|
|
37
|
-
exports.getWeekNumber = getWeekNumber;
|
|
38
|
-
/**
|
|
39
|
-
* 获取本地化的星期几
|
|
40
|
-
* @param weekday - 星期几 (0-6)
|
|
41
|
-
* @param options - 格式化选项
|
|
42
|
-
* @returns 本地化的星期几字符串
|
|
43
|
-
*/
|
|
44
|
-
function getLocalizedWeekday(weekday, options) {
|
|
45
|
-
const lang = options.locale?.split('-')[0] || 'zh';
|
|
46
|
-
return constants_1.WEEKDAY_MAP[lang]?.[weekday] || constants_1.WEEKDAY_MAP.zh[weekday];
|
|
47
|
-
}
|
|
48
|
-
exports.getLocalizedWeekday = getLocalizedWeekday;
|
|
49
|
-
/**
|
|
50
|
-
* 普通模式日期格式化
|
|
51
|
-
* @param input - 要格式化的日期输入
|
|
52
|
-
* @param formatStr - 格式化字符串
|
|
53
|
-
* @param options - 格式化选项
|
|
54
|
-
* @returns 格式化后的日期字符串
|
|
55
|
-
*/
|
|
56
|
-
function formatDatePlain(input, formatStr = 'YYYY-MM-DD HH:mm:ss', options = {}) {
|
|
57
|
-
const date = safeParseDate(input);
|
|
58
|
-
const mergedOptions = { ...constants_1.DEFAULT_DATE_FORMAT_OPTIONS, ...options };
|
|
59
|
-
// 获取日期各部分
|
|
60
|
-
const year = date.getFullYear();
|
|
61
|
-
const month = date.getMonth() + 1;
|
|
62
|
-
const day = date.getDate();
|
|
63
|
-
const hours = date.getHours();
|
|
64
|
-
const minutes = date.getMinutes();
|
|
65
|
-
const seconds = date.getSeconds();
|
|
66
|
-
const milliseconds = date.getMilliseconds();
|
|
67
|
-
const weekday = date.getDay();
|
|
68
|
-
const quarter = Math.floor((date.getMonth() + 3) / 3);
|
|
69
|
-
const weekNumber = getWeekNumber(date);
|
|
70
|
-
// 12小时制
|
|
71
|
-
const hours12 = hours % 12 || 12;
|
|
72
|
-
const ampm = hours < 12 ? 'AM' : 'PM';
|
|
73
|
-
const ampmLower = ampm.toLowerCase();
|
|
74
|
-
let result = formatStr;
|
|
75
|
-
// 优先替换 timestamp,避免被拆解
|
|
76
|
-
if (result.includes('timestamp')) {
|
|
77
|
-
result = result.replace(/timestamp/g, date.getTime().toString());
|
|
78
|
-
}
|
|
79
|
-
// 2. 应用自定义格式化器(优先级最高)
|
|
80
|
-
if (mergedOptions.customFormatters) {
|
|
81
|
-
Object.entries(mergedOptions.customFormatters).forEach(([token, formatter]) => {
|
|
82
|
-
const escapedToken = token.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
|
83
|
-
const regex = new RegExp(`(?<![a-zA-Z0-9])${escapedToken}(?![a-zA-Z0-9])`, 'g');
|
|
84
|
-
result = result.replace(regex, formatter(date));
|
|
85
|
-
});
|
|
86
|
-
}
|
|
87
|
-
// 3. 替换多字符标记(2-4个字符)
|
|
88
|
-
const multiCharReplacements = {
|
|
89
|
-
YYYY: year.toString().padStart(4, '0'),
|
|
90
|
-
YY: year.toString().slice(-2),
|
|
91
|
-
MM: month.toString().padStart(2, '0'),
|
|
92
|
-
DD: day.toString().padStart(2, '0'),
|
|
93
|
-
HH: hours.toString().padStart(2, '0'),
|
|
94
|
-
hh: hours12.toString().padStart(2, '0'),
|
|
95
|
-
mm: minutes.toString().padStart(2, '0'),
|
|
96
|
-
ss: seconds.toString().padStart(2, '0'),
|
|
97
|
-
SSS: milliseconds.toString().padStart(3, '0'),
|
|
98
|
-
WW: weekNumber.toString().padStart(2, '0'),
|
|
99
|
-
dd: getLocalizedWeekday(weekday, mergedOptions),
|
|
100
|
-
};
|
|
101
|
-
Object.entries(multiCharReplacements).forEach(([token, value]) => {
|
|
102
|
-
const regex = new RegExp(`\\b${token}\\b|${token}(?![a-zA-Z0-9])`, 'g');
|
|
103
|
-
result = result.replace(regex, value);
|
|
104
|
-
});
|
|
105
|
-
// 4. 替换单字符标记(使用更精确的匹配)
|
|
106
|
-
const singleCharReplacements = {
|
|
107
|
-
Y: year.toString(),
|
|
108
|
-
M: month.toString(),
|
|
109
|
-
D: day.toString(),
|
|
110
|
-
H: hours.toString(),
|
|
111
|
-
h: hours12.toString(),
|
|
112
|
-
m: minutes.toString(),
|
|
113
|
-
s: seconds.toString(),
|
|
114
|
-
W: weekNumber.toString(),
|
|
115
|
-
d: weekday.toString(),
|
|
116
|
-
Q: quarter.toString(),
|
|
117
|
-
A: ampm,
|
|
118
|
-
a: ampmLower,
|
|
119
|
-
};
|
|
120
|
-
Object.entries(singleCharReplacements).forEach(([token, value]) => {
|
|
121
|
-
const regex = new RegExp(`(?<![a-zA-Z0-9])${token}(?![a-zA-Z0-9])`, 'g');
|
|
122
|
-
result = result.replace(regex, value);
|
|
123
|
-
});
|
|
124
|
-
return result;
|
|
125
|
-
}
|
|
126
|
-
exports.formatDatePlain = formatDatePlain;
|
|
127
|
-
exports.default = formatDatePlain;
|
|
128
|
-
//# sourceMappingURL=formatDatePlain.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"formatDatePlain.js","sourceRoot":"","sources":["../../src/date/formatDatePlain.ts"],"names":[],"mappings":"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"}
|