@kkkf/utils 0.0.1 → 0.0.2

package/dist/index.d.mts

@@ -7,4 +7,15 @@ declare function multiply(a: number, b: number): number;
 /** 精确除法 */
 declare function divide(a: number, b: number): number;
 
-export { add, divide, multiply, subtract };
+/**
+ * 计算两个日期相隔的天数，返回中文描述
+ *
+ * @example
+ * dateDiff('2024-01-01', '2024-01-02')    → '1天'
+ * dateDiff('2024/01/01', '2024.02.02')    → '1个月零1天'
+ * dateDiff('20240101', '2025-03-05')      → '1年零2个月零4天'
+ * dateDiff('2024-01-01', '2024-01-01')    → '0天'
+ */
+declare function dateDiff(start: string | number | Date, end: string | number | Date): string;
+
+export { add, dateDiff, divide, multiply, subtract };

package/dist/index.d.ts

@@ -7,4 +7,15 @@ declare function multiply(a: number, b: number): number;
 /** 精确除法 */
 declare function divide(a: number, b: number): number;
 
-export { add, divide, multiply, subtract };
+/**
+ * 计算两个日期相隔的天数，返回中文描述
+ *
+ * @example
+ * dateDiff('2024-01-01', '2024-01-02')    → '1天'
+ * dateDiff('2024/01/01', '2024.02.02')    → '1个月零1天'
+ * dateDiff('20240101', '2025-03-05')      → '1年零2个月零4天'
+ * dateDiff('2024-01-01', '2024-01-01')    → '0天'
+ */
+declare function dateDiff(start: string | number | Date, end: string | number | Date): string;
+
+export { add, dateDiff, divide, multiply, subtract };

package/dist/index.js

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   add: () => add,
+  dateDiff: () => dateDiff,
   divide: () => divide,
   multiply: () => multiply,
   subtract: () => subtract
@@ -58,9 +59,45 @@ function divide(a, b) {
   const intB = Number(String(b).replace(".", ""));
   return intA / intB * Math.pow(10, lenB - lenA);
 }
+
+// src/date.ts
+function parseDate(input) {
+  if (input instanceof Date) return input;
+  if (typeof input === "number") return new Date(input);
+  const str = input.trim();
+  if (/^\d{8}$/.test(str)) {
+    const y = str.slice(0, 4);
+    const m = str.slice(4, 6);
+    const d = str.slice(6, 8);
+    return /* @__PURE__ */ new Date(`${y}-${m}-${d}`);
+  }
+  const normalized = str.replace(/[/.]/g, "-");
+  const date = new Date(normalized);
+  if (isNaN(date.getTime())) {
+    throw new Error(`\u65E0\u6CD5\u89E3\u6790\u65E5\u671F: ${input}`);
+  }
+  return date;
+}
+function dateDiff(start, end) {
+  const startDate = parseDate(start);
+  const endDate = parseDate(end);
+  const [earlier, later] = startDate <= endDate ? [startDate, endDate] : [endDate, startDate];
+  const diffTime = later.getTime() - earlier.getTime();
+  const totalDays = Math.floor(diffTime / (1e3 * 60 * 60 * 24));
+  if (totalDays === 0) return "0\u5929";
+  const years = Math.floor(totalDays / 365);
+  const months = Math.floor(totalDays % 365 / 30);
+  const days = totalDays % 365 % 30;
+  const parts = [];
+  if (years > 0) parts.push(`${years}\u5E74`);
+  if (months > 0) parts.push(`${months}\u4E2A\u6708`);
+  if (days > 0) parts.push(`${days}\u5929`);
+  return parts.join("\u96F6");
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   add,
+  dateDiff,
   divide,
   multiply,
   subtract

package/dist/index.mjs

@@ -29,8 +29,44 @@ function divide(a, b) {
   const intB = Number(String(b).replace(".", ""));
   return intA / intB * Math.pow(10, lenB - lenA);
 }
+
+// src/date.ts
+function parseDate(input) {
+  if (input instanceof Date) return input;
+  if (typeof input === "number") return new Date(input);
+  const str = input.trim();
+  if (/^\d{8}$/.test(str)) {
+    const y = str.slice(0, 4);
+    const m = str.slice(4, 6);
+    const d = str.slice(6, 8);
+    return /* @__PURE__ */ new Date(`${y}-${m}-${d}`);
+  }
+  const normalized = str.replace(/[/.]/g, "-");
+  const date = new Date(normalized);
+  if (isNaN(date.getTime())) {
+    throw new Error(`\u65E0\u6CD5\u89E3\u6790\u65E5\u671F: ${input}`);
+  }
+  return date;
+}
+function dateDiff(start, end) {
+  const startDate = parseDate(start);
+  const endDate = parseDate(end);
+  const [earlier, later] = startDate <= endDate ? [startDate, endDate] : [endDate, startDate];
+  const diffTime = later.getTime() - earlier.getTime();
+  const totalDays = Math.floor(diffTime / (1e3 * 60 * 60 * 24));
+  if (totalDays === 0) return "0\u5929";
+  const years = Math.floor(totalDays / 365);
+  const months = Math.floor(totalDays % 365 / 30);
+  const days = totalDays % 365 % 30;
+  const parts = [];
+  if (years > 0) parts.push(`${years}\u5E74`);
+  if (months > 0) parts.push(`${months}\u4E2A\u6708`);
+  if (days > 0) parts.push(`${days}\u5929`);
+  return parts.join("\u96F6");
+}
 export {
   add,
+  dateDiff,
   divide,
   multiply,
   subtract

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kkkf/utils",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",

package/src/date.ts

@@ -0,0 +1,65 @@
+/**
+ * 解析任意格式的日期字符串为 Date 对象
+ * 支持：2024-01-01、2024/01/01、2024.01.01、20240101、Date对象、时间戳
+ */
+function parseDate(input: string | number | Date): Date {
+  if (input instanceof Date) return input
+  if (typeof input === 'number') return new Date(input)
+
+  // 去掉首尾空格
+  const str = input.trim()
+
+  // 处理纯数字：20240101
+  if (/^\d{8}$/.test(str)) {
+    const y = str.slice(0, 4)
+    const m = str.slice(4, 6)
+    const d = str.slice(6, 8)
+    return new Date(`${y}-${m}-${d}`)
+  }
+
+  // 统一把 / . 替换成 -
+  const normalized = str.replace(/[/.]/g, '-')
+  const date = new Date(normalized)
+
+  if (isNaN(date.getTime())) {
+    throw new Error(`无法解析日期: ${input}`)
+  }
+
+  return date
+}
+
+/**
+ * 计算两个日期相隔的天数，返回中文描述
+ *
+ * @example
+ * dateDiff('2024-01-01', '2024-01-02')    → '1天'
+ * dateDiff('2024/01/01', '2024.02.02')    → '1个月零1天'
+ * dateDiff('20240101', '2025-03-05')      → '1年零2个月零4天'
+ * dateDiff('2024-01-01', '2024-01-01')    → '0天'
+ */
+export function dateDiff(start: string | number | Date, end: string | number | Date): string {
+  const startDate = parseDate(start)
+  const endDate = parseDate(end)
+
+  // 保证 start <= end
+  const [earlier, later] = startDate <= endDate
+    ? [startDate, endDate]
+    : [endDate, startDate]
+
+  // 计算总天数
+  const diffTime = later.getTime() - earlier.getTime()
+  const totalDays = Math.floor(diffTime / (1000 * 60 * 60 * 24))
+
+  if (totalDays === 0) return '0天'
+
+  const years = Math.floor(totalDays / 365)
+  const months = Math.floor((totalDays % 365) / 30)
+  const days = totalDays % 365 % 30
+
+  const parts: string[] = []
+  if (years > 0) parts.push(`${years}年`)
+  if (months > 0) parts.push(`${months}个月`)
+  if (days > 0) parts.push(`${days}天`)
+
+  return parts.join('零')
+}

package/src/index.ts

@@ -1 +1,2 @@
-export { add, subtract, multiply, divide } from './math'
+export { add, subtract, multiply, divide } from './math'
+export { dateDiff } from './date'