@qimen-lab/core 0.1.1

package/dist/utils/date/calculation/days.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addDays = addDays;
+exports.getWeekNumber = getWeekNumber;
+exports.getISOWeek = getISOWeek;
+exports.getISOWeeksInYear = getISOWeeksInYear;
+exports.getFirstDayOfWeek = getFirstDayOfWeek;
+/**
+ * 为指定日期添加天数
+ * @param date 基准日期
+ * @param days 要添加的天数
+ * @returns 添加天数后的新日期
+ */
+function addDays(date, days) {
+    const d = new Date(date);
+    d.setDate(d.getDate() + days);
+    return d;
+}
+/**
+ * 获取指定日期在年内的周数
+ * @param date 指定日期
+ * @returns 该日期在年内的周数
+ */
+function getWeekNumber(date) {
+    const d = new Date(date);
+    const firstDayOfYear = getFirstDayOfYear(d);
+    const diff = Math.round((d.getTime() - firstDayOfYear.getTime()) / (7 * 24 * 60 * 60 * 1000));
+    return Math.ceil(diff / 7);
+}
+/**
+ * 获取指定日期的ISO周数
+ * @param date 指定日期
+ * @returns ISO周数
+ */
+function getISOWeek(date) {
+    const d = new Date(date);
+    const year = d.getFullYear();
+    const firstDayOfYear = getFirstDayOfYear(date);
+    const dayOfWeek = firstDayOfYear.getDay();
+    const diff = d.getTime() - firstDayOfYear.getTime();
+    const daysSinceFirstMonday = Math.floor(diff / (24 * 60 * 60 * 1000)) + (dayOfWeek === 0 ? -6 : dayOfWeek - 1);
+    return Math.floor(daysSinceFirstMonday / 7) + 1;
+}
+/**
+ * 获取指定日期所在年的ISO周数总数
+ * @param date 指定日期
+ * @returns 该年ISO周数总数
+ */
+function getISOWeeksInYear(date) {
+    const d = new Date(date);
+    const year = d.getFullYear();
+    const firstDayOfYear = getFirstDayOfYear(date);
+    const dayOfWeek = firstDayOfYear.getDay();
+    const diff = new Date(year + 1, 0, 1).getTime() - firstDayOfYear.getTime();
+    const daysSinceFirstMonday = Math.floor(diff / (24 * 60 * 60 * 1000)) + (dayOfWeek === 0 ? -6 : dayOfWeek - 1);
+    return Math.ceil(daysSinceFirstMonday / 7);
+}
+/**
+ * 获取指定日期所在年的第一天
+ * @param date 指定日期
+ * @returns 该年第一天的日期对象
+ */
+function getFirstDayOfYear(date) {
+    const d = new Date(date);
+    return new Date(d.getFullYear(), 0, 1);
+}
+/**
+ * 获取指定日期所在周的第一天（周日为一周的开始）
+ * @param date 指定日期
+ * @returns 该周第一天的日期对象
+ */
+function getFirstDayOfWeek(date) {
+    const d = new Date(date);
+    const diff = d.getDay() === 0 ? 6 : d.getDay() - 1;
+    return addDays(d, -diff);
+}
+//# sourceMappingURL=days.js.map

package/dist/utils/date/calculation/days.js.map

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

package/dist/utils/date/calculation/index.d.ts

@@ -0,0 +1,5 @@
+export * from './days';
+export * from './months';
+export * from './years';
+export * from './quarters';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/date/calculation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/utils/date/calculation/index.ts"],"names":[],"mappings":"AACA,cAAc,QAAQ,CAAC;AAGvB,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,YAAY,CAAC"}

package/dist/utils/date/calculation/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// 日期天数相关计算功能
+__exportStar(require("./days"), exports);
+// 日期月份相关计算功能
+__exportStar(require("./months"), exports);
+// 日期年份相关计算功能
+__exportStar(require("./years"), exports);
+// 日期季度相关计算功能
+__exportStar(require("./quarters"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/date/calculation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/utils/date/calculation/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,aAAa;AACb,yCAAuB;AAEvB,aAAa;AACb,2CAAyB;AAEzB,aAAa;AACb,0CAAwB;AAExB,aAAa;AACb,6CAA2B"}

package/dist/utils/date/calculation/months.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 为指定日期添加月份
+ * @param date 基准日期
+ * @param months 要添加的月数
+ * @returns 添加月份后的新日期
+ */
+export declare function addMonths(date: Date | string, months: number): Date;
+/**
+ * 获取指定年月的天数
+ * @param year 年份
+ * @param month 月份（从0开始）
+ * @returns 该年月的天数
+ */
+export declare function getDaysInMonth(year: number, month: number): number;
+/**
+ * 获取指定日期所在月份的第一天
+ * @param date 指定日期
+ * @returns 该月第一天的日期对象
+ */
+export declare function getFirstDayOfMonth(date: Date | string): Date;
+/**
+ * 获取指定日期所在月份的最后一天
+ * @param date 指定日期
+ * @returns 该月最后一天的日期对象
+ */
+export declare function getLastDayOfMonth(date: Date | string): Date;
+//# sourceMappingURL=months.d.ts.map

package/dist/utils/date/calculation/months.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"months.d.ts","sourceRoot":"","sources":["../../../../../src/utils/date/calculation/months.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAOnE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAG3D"}

package/dist/utils/date/calculation/months.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addMonths = addMonths;
+exports.getDaysInMonth = getDaysInMonth;
+exports.getFirstDayOfMonth = getFirstDayOfMonth;
+exports.getLastDayOfMonth = getLastDayOfMonth;
+/**
+ * 为指定日期添加月份
+ * @param date 基准日期
+ * @param months 要添加的月数
+ * @returns 添加月份后的新日期
+ */
+function addMonths(date, months) {
+    const d = new Date(date);
+    const year = d.getFullYear();
+    const month = d.getMonth() + months;
+    const day = Math.min(d.getDate(), getDaysInMonth(year, month));
+    d.setFullYear(year, month, day);
+    return d;
+}
+/**
+ * 获取指定年月的天数
+ * @param year 年份
+ * @param month 月份（从0开始）
+ * @returns 该年月的天数
+ */
+function getDaysInMonth(year, month) {
+    return new Date(year, month + 1, 0).getDate();
+}
+/**
+ * 获取指定日期所在月份的第一天
+ * @param date 指定日期
+ * @returns 该月第一天的日期对象
+ */
+function getFirstDayOfMonth(date) {
+    const d = new Date(date);
+    return new Date(d.getFullYear(), d.getMonth(), 1);
+}
+/**
+ * 获取指定日期所在月份的最后一天
+ * @param date 指定日期
+ * @returns 该月最后一天的日期对象
+ */
+function getLastDayOfMonth(date) {
+    const d = new Date(date);
+    return new Date(d.getFullYear(), d.getMonth() + 1, 0);
+}
+//# sourceMappingURL=months.js.map

package/dist/utils/date/calculation/months.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"months.js","sourceRoot":"","sources":["../../../../../src/utils/date/calculation/months.ts"],"names":[],"mappings":";;AAMA,8BAOC;AAQD,wCAEC;AAOD,gDAGC;AAOD,8CAGC;AA3CD;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,IAAmB,EAAE,MAAc;IACzD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,EAAE,GAAG,MAAM,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IAChC,OAAO,CAAC,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,IAAY,EAAE,KAAa;IACtD,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,IAAmB;IAClD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,IAAmB;IACjD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/utils/date/calculation/quarters.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 获取指定日期的季度
+ * @param date 指定日期
+ * @returns 季度（1-4）
+ */
+export declare function getQuarter(date: Date | string): number;
+//# sourceMappingURL=quarters.d.ts.map

package/dist/utils/date/calculation/quarters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quarters.d.ts","sourceRoot":"","sources":["../../../../../src/utils/date/calculation/quarters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAGtD"}

package/dist/utils/date/calculation/quarters.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getQuarter = getQuarter;
+/**
+ * 获取指定日期的季度
+ * @param date 指定日期
+ * @returns 季度（1-4）
+ */
+function getQuarter(date) {
+    const d = new Date(date);
+    return Math.floor((d.getMonth() + 3) / 3);
+}
+//# sourceMappingURL=quarters.js.map

package/dist/utils/date/calculation/quarters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quarters.js","sourceRoot":"","sources":["../../../../../src/utils/date/calculation/quarters.ts"],"names":[],"mappings":";;AAKA,gCAGC;AARD;;;;GAIG;AACH,SAAgB,UAAU,CAAC,IAAmB;IAC1C,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/utils/date/calculation/years.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 为指定日期添加年份
+ * @param date 基准日期
+ * @param years 要添加的年数
+ * @returns 添加年份后的新日期
+ */
+export declare function addYears(date: Date | string, years: number): Date;
+/**
+ * 获取指定日期所在年的第一天
+ * @param date 指定日期
+ * @returns 该年第一天的日期对象
+ */
+export declare function getFirstDayOfYear(date: Date | string): Date;
+/**
+ * 获取指定日期所在年的最后一天
+ * @param date 指定日期
+ * @returns 该年最后一天的日期对象
+ */
+export declare function getLastDayOfYear(date: Date | string): Date;
+//# sourceMappingURL=years.d.ts.map

package/dist/utils/date/calculation/years.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"years.d.ts","sourceRoot":"","sources":["../../../../../src/utils/date/calculation/years.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAqBjE;AAWD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAG3D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAG1D"}

package/dist/utils/date/calculation/years.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addYears = addYears;
+exports.getFirstDayOfYear = getFirstDayOfYear;
+exports.getLastDayOfYear = getLastDayOfYear;
+/**
+ * 为指定日期添加年份
+ * @param date 基准日期
+ * @param years 要添加的年数
+ * @returns 添加年份后的新日期
+ */
+function addYears(date, years) {
+    const d = new Date(date);
+    const day = d.getDate();
+    const month = d.getMonth();
+    const originalYear = d.getFullYear();
+    const targetYear = originalYear + years;
+    // 创建目标年份的新日期，但要检查是否是2月29日的情况
+    const result = new Date(d);
+    result.setFullYear(targetYear);
+    // 检查是否是闰年的2月29日，且目标年份不是闰年
+    // 这种情况下，JavaScript会自动将日期调整到3月1日
+    if (month === 1 && day === 29 && isLeapYear(originalYear) && !isLeapYear(targetYear)) {
+        // 如果原始日期是闰年的2月29日，但目标年份不是闰年，
+        // 则将日期调整为2月28日（目标年2月的最后一天）
+        result.setMonth(1); // 2月
+        result.setDate(28); // 28日
+    }
+    return result;
+}
+/**
+ * 判断是否为闰年
+ * @param year 年份
+ * @returns 是否为闰年
+ */
+function isLeapYear(year) {
+    return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+}
+/**
+ * 获取指定日期所在年的第一天
+ * @param date 指定日期
+ * @returns 该年第一天的日期对象
+ */
+function getFirstDayOfYear(date) {
+    const d = new Date(date);
+    return new Date(d.getFullYear(), 0, 1);
+}
+/**
+ * 获取指定日期所在年的最后一天
+ * @param date 指定日期
+ * @returns 该年最后一天的日期对象
+ */
+function getLastDayOfYear(date) {
+    const d = new Date(date);
+    return new Date(d.getFullYear(), 11, 31);
+}
+//# sourceMappingURL=years.js.map

package/dist/utils/date/calculation/years.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"years.js","sourceRoot":"","sources":["../../../../../src/utils/date/calculation/years.ts"],"names":[],"mappings":";;AAMA,4BAqBC;AAgBD,8CAGC;AAOD,4CAGC;AAxDD;;;;;GAKG;AACH,SAAgB,QAAQ,CAAC,IAAmB,EAAE,KAAa;IACvD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IACxB,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3B,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,UAAU,GAAG,YAAY,GAAG,KAAK,CAAC;IAExC,6BAA6B;IAC7B,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE/B,0BAA0B;IAC1B,gCAAgC;IAChC,IAAI,KAAK,KAAK,CAAC,IAAI,GAAG,KAAK,EAAE,IAAI,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACnF,6BAA6B;QAC7B,2BAA2B;QAC3B,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK;QACzB,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM;IAC9B,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAC,IAAY;IAC5B,OAAO,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,IAAmB;IACjD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,IAAmB;IAChD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAC7C,CAAC"}

package/dist/utils/date/calendar.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 日历日期接口，包含日期信息和显示状态
+ */
+export interface CalendarDay {
+    date: Date;
+    isCurrentMonth: boolean;
+    isToday: boolean;
+}
+/**
+ * 生成指定月份的日历视图，包含前后月份的补充日期
+ * @param year 年份
+ * @param month 月份 (1-12)
+ * @param startDayOfWeek 一周开始的星期，默认为0（星期日）
+ * @returns 42天的日期数组（6行7列）
+ */
+export declare function generateCalendarView(year: number, month: number, startDayOfWeek?: number): CalendarDay[];
+/**
+ * 获取指定月份的周数
+ * @param year 年份
+ * @param month 月份 (1-12)
+ * @param startDayOfWeek 一周开始的星期，默认为0（星期日）
+ * @returns 该月的周数
+ */
+export declare function getWeeksInMonth(year: number, month: number, startDayOfWeek?: number): number;
+/**
+ * 获取日期在月份中的周数
+ * @param date 日期
+ * @returns 该日期在月份中的周数
+ */
+export declare function getWeekNumberInMonth(date: Date): number;
+/**
+ * 获取月份的天数矩阵（二维数组）
+ * @param year 年份
+ * @param month 月份 (1-12)
+ * @param startDayOfWeek 一周开始的星期，默认为0（星期日）
+ * @returns 二维数组，每行代表一周
+ */
+export declare function getCalendarMatrix(year: number, month: number, startDayOfWeek?: number): CalendarDay[][];
+/**
+ * 获取一周的日期范围
+ * @param date 指定日期
+ * @param startDayOfWeek 一周开始的星期，默认为0（星期日）
+ * @returns 包含一周开始和结束日期的对象
+ */
+export declare function getWeekRange(date: Date, startDayOfWeek?: number): {
+    start: Date;
+    end: Date;
+};
+//# sourceMappingURL=calendar.d.ts.map

package/dist/utils/date/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../../../src/utils/date/calendar.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,cAAc,GAAE,MAAU,GAC3B,WAAW,EAAE,CAiCf;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,GAAE,MAAU,GAAG,MAAM,CAS/F;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAQvD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,cAAc,GAAE,MAAU,GAC3B,WAAW,EAAE,EAAE,CASjB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,GAAE,MAAU,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,CAW/F"}

package/dist/utils/date/calendar.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCalendarView = generateCalendarView;
+exports.getWeeksInMonth = getWeeksInMonth;
+exports.getWeekNumberInMonth = getWeekNumberInMonth;
+exports.getCalendarMatrix = getCalendarMatrix;
+exports.getWeekRange = getWeekRange;
+const calculation_1 = require("./calculation");
+/**
+ * 生成指定月份的日历视图，包含前后月份的补充日期
+ * @param year 年份
+ * @param month 月份 (1-12)
+ * @param startDayOfWeek 一周开始的星期，默认为0（星期日）
+ * @returns 42天的日期数组（6行7列）
+ */
+function generateCalendarView(year, month, startDayOfWeek = 0) {
+    const targetDate = new Date(year, month - 1, 1);
+    const firstDayOfMonth = (0, calculation_1.getFirstDayOfMonth)(targetDate);
+    const lastDayOfMonth = (0, calculation_1.getLastDayOfMonth)(targetDate);
+    // 获取当月第一天是星期几
+    const firstDayWeekday = firstDayOfMonth.getDay();
+    // 计算日历开始日期（需要向前补充的天数）
+    const startOffset = (firstDayWeekday - startDayOfWeek + 7) % 7;
+    // 获取日历开始日期
+    const calendarStart = (0, calculation_1.addDays)(firstDayOfMonth, -startOffset);
+    // 生成42天（6行7列）的日历数组
+    const calendarDays = [];
+    const today = new Date();
+    today.setHours(0, 0, 0, 0); // 重置时间部分，只比较日期
+    for (let i = 0; i < 42; i++) {
+        const date = (0, calculation_1.addDays)(calendarStart, i);
+        const dateWithoutTime = new Date(date);
+        dateWithoutTime.setHours(0, 0, 0, 0);
+        calendarDays.push({
+            date,
+            isCurrentMonth: date.getMonth() === targetDate.getMonth() &&
+                date.getFullYear() === targetDate.getFullYear(),
+            isToday: dateWithoutTime.getTime() === today.getTime(),
+        });
+    }
+    return calendarDays;
+}
+/**
+ * 获取指定月份的周数
+ * @param year 年份
+ * @param month 月份 (1-12)
+ * @param startDayOfWeek 一周开始的星期，默认为0（星期日）
+ * @returns 该月的周数
+ */
+function getWeeksInMonth(year, month, startDayOfWeek = 0) {
+    var _a, _b;
+    const days = generateCalendarView(year, month, startDayOfWeek);
+    const firstDay = (_a = days.find(day => day.isCurrentMonth)) === null || _a === void 0 ? void 0 : _a.date;
+    const lastDay = (_b = [...days].reverse().find(day => day.isCurrentMonth)) === null || _b === void 0 ? void 0 : _b.date;
+    const firstWeekNum = getWeekNumberInMonth(firstDay);
+    const lastWeekNum = getWeekNumberInMonth(lastDay);
+    return lastWeekNum - firstWeekNum + 1;
+}
+/**
+ * 获取日期在月份中的周数
+ * @param date 日期
+ * @returns 该日期在月份中的周数
+ */
+function getWeekNumberInMonth(date) {
+    const firstDayOfMonth = new Date(date.getFullYear(), date.getMonth(), 1);
+    const firstDayWeekday = firstDayOfMonth.getDay();
+    const dayInMonth = date.getDate();
+    const weekNumber = Math.ceil((dayInMonth + firstDayWeekday) / 7);
+    return weekNumber;
+}
+/**
+ * 获取月份的天数矩阵（二维数组）
+ * @param year 年份
+ * @param month 月份 (1-12)
+ * @param startDayOfWeek 一周开始的星期，默认为0（星期日）
+ * @returns 二维数组，每行代表一周
+ */
+function getCalendarMatrix(year, month, startDayOfWeek = 0) {
+    const days = generateCalendarView(year, month, startDayOfWeek);
+    const matrix = [];
+    for (let i = 0; i < 6; i++) {
+        matrix.push(days.slice(i * 7, (i + 1) * 7));
+    }
+    return matrix;
+}
+/**
+ * 获取一周的日期范围
+ * @param date 指定日期
+ * @param startDayOfWeek 一周开始的星期，默认为0（星期日）
+ * @returns 包含一周开始和结束日期的对象
+ */
+function getWeekRange(date, startDayOfWeek = 0) {
+    const dayOfWeek = date.getDay();
+    const startOffset = (dayOfWeek - startDayOfWeek + 7) % 7;
+    const start = (0, calculation_1.addDays)(date, -startOffset);
+    const end = (0, calculation_1.addDays)(start, 6);
+    return {
+        start,
+        end,
+    };
+}
+//# sourceMappingURL=calendar.js.map

package/dist/utils/date/calendar.js.map

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

package/dist/utils/date/format.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 格式化日期为指定格式的字符串
+ * @param date 日期对象或日期字符串
+ * @param format 日期格式字符串，支持以下占位符：
+ * - yyyy: 四位年份
+ * - yy: 两位年份
+ * - MM: 两位月份
+ * - M: 月份
+ * - dd: 两位日期
+ * - d: 日期
+ * - HH: 两位小时（24小时制）
+ * - H: 小时（24小时制）
+ * - hh: 两位小时（12小时制）
+ * - h: 小时（12小时制）
+ * - mm: 两位分钟
+ * - m: 分钟
+ * - ss: 两位秒
+ * - s: 秒
+ * @returns 格式化后的日期字符串
+ */
+export declare function formatDate(date: Date | string, format: string): string;
+/**
+ * 根据指定格式解析日期字符串为Date对象
+ * @param date 日期字符串
+ * @param format 日期格式字符串
+ * @returns 解析后的Date对象，如果解析失败则返回null
+ */
+export declare function parse(date: string, format: string): Date | null;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/date/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../src/utils/date/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAgCtE;AAqGD;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAiD/D"}