sard 1.0.0 → 1.0.2

package/utils/date.js

@@ -0,0 +1,803 @@
+import { clamp } from "./number.js";
+import { escapeRegExp } from "./regexp.js";
+//#region packages/sard/utils/date.ts
+/**
+* 判断是否为闰年。
+*/
+function isLeapYear(year) {
+	return year % 4 === 0 && year % 100 !== 0 || year % 400 === 0;
+}
+const monthDays = [
+	31,
+	28,
+	31,
+	30,
+	31,
+	30,
+	31,
+	31,
+	30,
+	31,
+	30,
+	31
+];
+/**
+* 获取某月的天数，月份从0开始。
+*/
+function getDaysInMonth(year, month) {
+	if (month === 1) return isLeapYear(year) ? 29 : 28;
+	else return monthDays[month];
+}
+/**
+* 获取当前日期是一年中的第几天。
+*/
+function getDayOfYear(date) {
+	const year = date.getFullYear();
+	const month = date.getMonth();
+	const d = date.getDate();
+	let days = 0;
+	for (let m = 0; m < month; m++) days += getDaysInMonth(year, m);
+	return days + d;
+}
+/**
+* 获取指定月份第一天是星期几，月份从0开始。
+*/
+function getFirstDayWeekday(year, month) {
+	return new Date(year, month, 1).getDay();
+}
+/**
+* 获取从基准日期（如1970-01-01）到指定日期的总天数。
+*/
+function getDaysSinceUnixEpoch(date) {
+	return Math.floor(date.getTime() / 1e3 / 60 / 60 / 24);
+}
+/**
+* 把日期转换为年月日数值，例如：2025年7月1号 -> 20250601。
+*/
+function toDateNumber(date) {
+	return date.getFullYear() * 1e4 + date.getMonth() * 100 + date.getDate();
+}
+/**
+* 把日期转换为年月日字符串，，例如：2025年7月1号 -> 2025-7-1。
+*/
+function toDateString(date) {
+	return date.getFullYear() + "-" + (date.getMonth() + 1) + "-" + date.getDate();
+}
+/**
+* 把日期转换为年月数值，例如：2025年7月1号 -> 20250600。
+*/
+function toMonthNumber(date) {
+	return date.getFullYear() * 1e4 + date.getMonth() * 100;
+}
+/**
+* 计算当前月份1号前面需要显示的上个月末尾的天数。
+*/
+function getDaysBeforeFirstDay(year, month, weekStartsOn = 0) {
+	return (getFirstDayWeekday(year, month) - weekStartsOn + 7) % 7;
+}
+/**
+* 获取当前月份最后一天之后需要显示的下个月开始的天数。
+*/
+function getDaysAfterLastDay(year, month, weekStartsOn = 0) {
+	return 42 - getDaysBeforeFirstDay(year, month, weekStartsOn) - getDaysInMonth(year, month);
+}
+/**
+* 获取当前月份1号之前需要显示的上个月末尾的日期。
+*/
+function getPrevMonthTailDays(year, month, weekStartsOn = 0) {
+	const daysBefore = getDaysBeforeFirstDay(year, month, weekStartsOn);
+	const dates = [];
+	for (let i = daysBefore - 1; i >= 0; i--) dates.push(new Date(year, month, -i));
+	return dates;
+}
+/**
+* 获取当前月份最后一天之后需要显示的下个月开始的日期。
+*/
+function getNextMonthHeadDays(year, month, weekStartsOn = 0) {
+	const daysAfter = getDaysAfterLastDay(year, month, weekStartsOn);
+	const dates = [];
+	for (let i = 1; i <= daysAfter; i++) dates.push(new Date(year, month + 1, i));
+	return dates;
+}
+const dateTokensReg = /(YYYY|YY|MM|M|DD|D|HH|H|hh|h|mm|m|ss|s|SSS)/g;
+const dateGetters = {
+	YYYY: (date) => String(date.getFullYear()).padStart(4, "0"),
+	YY: (date) => String(date.getFullYear()).slice(-2),
+	MM: (date) => String(date.getMonth() + 1).padStart(2, "0"),
+	M: (date) => String(date.getMonth() + 1),
+	DD: (date) => String(date.getDate()).padStart(2, "0"),
+	D: (date) => String(date.getDate()),
+	HH: (date) => String(date.getHours()).padStart(2, "0"),
+	H: (date) => String(date.getHours()),
+	hh: (date) => String(date.getHours() % 24).padStart(2, "0"),
+	h: (date) => String(date.getHours() % 24),
+	mm: (date) => String(date.getMinutes()).padStart(2, "0"),
+	m: (date) => String(date.getMinutes()),
+	ss: (date) => String(date.getSeconds()).padStart(2, "0"),
+	s: (date) => String(date.getSeconds()),
+	SSS: (date) => String(date.getMilliseconds()).padStart(3, "0")
+};
+/**
+* 根据传入的占位符返回格式化后的日期。
+*/
+function formatDate(date, format = "YYYY-MM-DD HH:mm:ss") {
+	return format.replace(dateTokensReg, (match) => {
+		return dateGetters[match](date);
+	});
+}
+const defaultTokenFrags = [
+	"YYYY",
+	"MM",
+	"DD",
+	"HH",
+	"mm",
+	"ss",
+	"SSS"
+];
+const dateSetters = {
+	YYYY: (date, year) => date.setFullYear(year),
+	YY: (date, year) => date.setFullYear(year),
+	MM: (date, month) => date.setMonth(month - 1),
+	M: (date, month) => date.setMonth(month - 1),
+	DD: (date, d) => date.setDate(d),
+	D: (date, d) => date.setDate(d),
+	HH: (date, hours) => date.setHours(hours),
+	H: (date, hours) => date.setHours(hours),
+	hh: (date, hours) => date.setHours(hours),
+	h: (date, hours) => date.setHours(hours),
+	mm: (date, minutes) => date.setMinutes(minutes),
+	m: (date, minutes) => date.setMinutes(minutes),
+	ss: (date, seconds) => date.setSeconds(seconds),
+	s: (date, seconds) => date.setSeconds(seconds),
+	SSS: (date, milliseconds) => date.setMilliseconds(milliseconds)
+};
+function parseDateWithoutFormat(value) {
+	const numbers = value.split(/\D+/).filter(Boolean);
+	const tokens = defaultTokenFrags.slice(0, numbers.length);
+	const date = new Date(0, 0);
+	tokens.forEach((token, i) => {
+		dateSetters[token](date, Number(numbers[i]));
+	});
+	return date;
+}
+/**
+* 解析日期的字符串表示形式，并返回 Date 实例对象。
+*/
+function parseDate(value, format) {
+	if (!format) return parseDateWithoutFormat(value);
+	const frags = format.split(dateTokensReg);
+	const dateFrags = new RegExp("^" + frags.filter((_, i) => i % 2 === 0).map((item) => escapeRegExp(item)).join("(.*)") + "$").exec(value)?.slice(1);
+	if (!dateFrags) return parseDateWithoutFormat(value);
+	const tokenFrags = frags.filter((_, i) => i % 2 !== 0);
+	const date = /* @__PURE__ */ new Date(0);
+	tokenFrags.forEach((token, i) => {
+		dateSetters[token](date, Number(dateFrags[i]));
+	});
+	return date;
+}
+function toDate(date, valueFormat) {
+	if (date instanceof Date) return date;
+	return parseDate(date, valueFormat);
+}
+function minmaxDate(date, minDate, maxDate) {
+	return new Date(clamp(date.getTime(), minDate.getTime(), maxDate.getTime()));
+}
+function getPrevMonthDate(date) {
+	return new Date(date.getFullYear(), date.getMonth() - 1, 1);
+}
+function getNextMonthDate(date) {
+	return new Date(date.getFullYear(), date.getMonth() + 1, 1);
+}
+/****************************************************************
+* 农历
+****************************************************************/
+const lunarInfo = [
+	19416,
+	19168,
+	42352,
+	21717,
+	53856,
+	55632,
+	91476,
+	22176,
+	39632,
+	21970,
+	19168,
+	42422,
+	42192,
+	53840,
+	119381,
+	46400,
+	54944,
+	44450,
+	38320,
+	84343,
+	18800,
+	42160,
+	46261,
+	27216,
+	27968,
+	109396,
+	11104,
+	38256,
+	21234,
+	18800,
+	25958,
+	54432,
+	59984,
+	92821,
+	23248,
+	11104,
+	100067,
+	37600,
+	116951,
+	51536,
+	54432,
+	120998,
+	46416,
+	22176,
+	107956,
+	9680,
+	37584,
+	53938,
+	43344,
+	46423,
+	27808,
+	46416,
+	86869,
+	19872,
+	42416,
+	83315,
+	21168,
+	43432,
+	59728,
+	27296,
+	44710,
+	43856,
+	19296,
+	43748,
+	42352,
+	21088,
+	62051,
+	55632,
+	23383,
+	22176,
+	38608,
+	19925,
+	19152,
+	42192,
+	54484,
+	53840,
+	54616,
+	46400,
+	46752,
+	103846,
+	38320,
+	18864,
+	43380,
+	42160,
+	45690,
+	27216,
+	27968,
+	44870,
+	43872,
+	38256,
+	19189,
+	18800,
+	25776,
+	29859,
+	59984,
+	27480,
+	23232,
+	43872,
+	38613,
+	37600,
+	51552,
+	55636,
+	54432,
+	55888,
+	30034,
+	22176,
+	43959,
+	9680,
+	37584,
+	51893,
+	43344,
+	46240,
+	47780,
+	44368,
+	21977,
+	19360,
+	42416,
+	86390,
+	21168,
+	43312,
+	31060,
+	27296,
+	44368,
+	23378,
+	19296,
+	42726,
+	42208,
+	53856,
+	60005,
+	54576,
+	23200,
+	30371,
+	38608,
+	19195,
+	19152,
+	42192,
+	118966,
+	53840,
+	54560,
+	56645,
+	46496,
+	22224,
+	21938,
+	18864,
+	42359,
+	42160,
+	43600,
+	111189,
+	27936,
+	44448,
+	84835,
+	37744,
+	18936,
+	18800,
+	25776,
+	92326,
+	59984,
+	27424,
+	108228,
+	43744,
+	37600,
+	53987,
+	51552,
+	54615,
+	54432,
+	55888,
+	23893,
+	22176,
+	42704,
+	21972,
+	21200,
+	43448,
+	43344,
+	46240,
+	46758,
+	44368,
+	21920,
+	43940,
+	42416,
+	21168,
+	45683,
+	26928,
+	29495,
+	27296,
+	44368,
+	84821,
+	19296,
+	42352,
+	21732,
+	53600,
+	59752,
+	54560,
+	55968,
+	92838,
+	22224,
+	19168,
+	43476,
+	41680,
+	53584,
+	62034,
+	54560
+];
+const springFestivals = [
+	[1, 31],
+	[2, 19],
+	[2, 8],
+	[1, 29],
+	[2, 16],
+	[2, 4],
+	[1, 25],
+	[2, 13],
+	[2, 2],
+	[1, 22],
+	[2, 10],
+	[1, 30],
+	[2, 18],
+	[2, 6],
+	[1, 26],
+	[2, 14],
+	[2, 3],
+	[1, 23],
+	[2, 11],
+	[2, 1],
+	[2, 20],
+	[2, 8],
+	[1, 28],
+	[2, 16],
+	[2, 5],
+	[1, 24],
+	[2, 13],
+	[2, 2],
+	[1, 23],
+	[2, 10],
+	[1, 30],
+	[2, 17],
+	[2, 6],
+	[1, 26],
+	[2, 14],
+	[2, 4],
+	[1, 24],
+	[2, 11],
+	[1, 31],
+	[2, 19],
+	[2, 8],
+	[1, 27],
+	[2, 15],
+	[2, 5],
+	[1, 25],
+	[2, 13],
+	[2, 2],
+	[1, 22],
+	[2, 10],
+	[1, 29],
+	[2, 17],
+	[2, 6],
+	[1, 27],
+	[2, 14],
+	[2, 3],
+	[1, 24],
+	[2, 12],
+	[1, 31],
+	[2, 18],
+	[2, 8],
+	[1, 28],
+	[2, 15],
+	[2, 5],
+	[1, 25],
+	[2, 13],
+	[2, 2],
+	[1, 21],
+	[2, 9],
+	[1, 30],
+	[2, 17],
+	[2, 6],
+	[1, 27],
+	[2, 15],
+	[2, 3],
+	[1, 23],
+	[2, 11],
+	[1, 31],
+	[2, 18],
+	[2, 7],
+	[1, 28],
+	[2, 16],
+	[2, 5],
+	[1, 25],
+	[2, 13],
+	[2, 2],
+	[2, 20],
+	[2, 9],
+	[1, 29],
+	[2, 17],
+	[2, 6],
+	[1, 27],
+	[2, 15],
+	[2, 4],
+	[1, 23],
+	[2, 10],
+	[1, 31],
+	[2, 19],
+	[2, 7],
+	[1, 28],
+	[2, 16],
+	[2, 5],
+	[1, 24],
+	[2, 12],
+	[2, 1],
+	[1, 22],
+	[2, 9],
+	[1, 29],
+	[2, 18],
+	[2, 7],
+	[1, 26],
+	[2, 14],
+	[2, 3],
+	[1, 23],
+	[2, 10],
+	[1, 31],
+	[2, 19],
+	[2, 8],
+	[1, 28],
+	[2, 16],
+	[2, 5],
+	[1, 25],
+	[2, 12],
+	[2, 1],
+	[1, 22],
+	[2, 10],
+	[1, 29],
+	[2, 17],
+	[2, 6],
+	[1, 26],
+	[2, 13],
+	[2, 3],
+	[1, 23],
+	[2, 11],
+	[1, 31],
+	[2, 19],
+	[2, 8],
+	[1, 28],
+	[2, 15],
+	[2, 4],
+	[1, 24],
+	[2, 12],
+	[2, 1],
+	[1, 22],
+	[2, 10],
+	[1, 30],
+	[2, 17],
+	[2, 6],
+	[1, 26],
+	[2, 14],
+	[2, 2],
+	[1, 23],
+	[2, 11],
+	[2, 1],
+	[2, 19],
+	[2, 8],
+	[1, 28],
+	[2, 15],
+	[2, 4],
+	[1, 24],
+	[2, 12],
+	[2, 2],
+	[1, 21],
+	[2, 9],
+	[1, 29],
+	[2, 17],
+	[2, 5],
+	[1, 26],
+	[2, 14],
+	[2, 3],
+	[1, 23],
+	[2, 11],
+	[1, 31],
+	[2, 19],
+	[2, 7],
+	[1, 27],
+	[2, 15],
+	[2, 5],
+	[1, 24],
+	[2, 12],
+	[2, 2],
+	[1, 22],
+	[2, 9],
+	[1, 29],
+	[2, 17],
+	[2, 6],
+	[1, 26],
+	[2, 14],
+	[2, 3],
+	[1, 24],
+	[2, 10],
+	[1, 30],
+	[2, 18],
+	[2, 7],
+	[1, 27],
+	[2, 15],
+	[2, 5],
+	[1, 25],
+	[2, 12],
+	[2, 1],
+	[1, 21],
+	[2, 9]
+];
+const baseLunarYear = 1900;
+/**
+* 获取农历某年闰月的月份，月份从1开始（0表示无闰月）。
+*/
+function getLunarLeapMonth(year) {
+	return lunarInfo[year - baseLunarYear] & 15;
+}
+/**
+* 获取农历某年闰月的天数。
+*/
+function getLunarLeapMonthDays(year) {
+	if (getLunarLeapMonth(year)) return lunarInfo[year - 1900] & 65536 ? 30 : 29;
+	return 0;
+}
+/**
+* 获取农历某年的总天数。
+*/
+function getLunarYearDays(year) {
+	let sum = 348;
+	const info = lunarInfo[year - baseLunarYear];
+	for (let i = 32768; i > 8; i >>= 1) sum += info & i ? 1 : 0;
+	return sum + getLunarLeapMonthDays(year);
+}
+/**
+* 获取农历某年某月的天数，月份从1开始。
+*/
+function getLunarMonthDays(year, month) {
+	return lunarInfo[year - 1900] & 65536 >> month ? 30 : 29;
+}
+/**
+* 公历转农历，月份从1开始（返回的闰月为负数）。
+*/
+function solarToLunar(year, month, day) {
+	const offsetDays = Math.floor((Date.UTC(year, month - 1, day) - Date.UTC(baseLunarYear, 0, 31)) / (1440 * 60 * 1e3));
+	let lunarYear = baseLunarYear;
+	let lunarMonth = 1;
+	let lunarDay = 1;
+	let isLeapMonth = false;
+	let daysRemaining = offsetDays;
+	while (true) {
+		const yearDays = getLunarYearDays(lunarYear);
+		if (daysRemaining < yearDays) break;
+		daysRemaining -= yearDays;
+		lunarYear++;
+	}
+	const leapMonth = getLunarLeapMonth(lunarYear);
+	let monthDays = 0;
+	let _month = 1;
+	for (; _month <= 12; _month++) {
+		if (leapMonth > 0 && _month === leapMonth + 1) {
+			monthDays = getLunarLeapMonthDays(lunarYear);
+			if (daysRemaining < monthDays) {
+				isLeapMonth = true;
+				_month--;
+				break;
+			}
+			daysRemaining -= monthDays;
+		}
+		monthDays = getLunarMonthDays(lunarYear, _month);
+		if (daysRemaining < monthDays) break;
+		daysRemaining -= monthDays;
+	}
+	lunarMonth = _month;
+	lunarDay = daysRemaining + 1;
+	return {
+		year: lunarYear,
+		month: lunarMonth * (isLeapMonth ? -1 : 1),
+		day: lunarDay
+	};
+}
+/**
+* 农历转公历（闰月需传递负数）。
+*/
+function lunarToSolar(year, month, day) {
+	const springFestival = springFestivals[year - baseLunarYear];
+	const solarDate = new Date(year, springFestival[0] - 1, springFestival[1]);
+	const leapMonth = lunarInfo[year - baseLunarYear] & 15;
+	let totalDays = 0;
+	const absMonth = Math.abs(month);
+	for (let m = 1; m < absMonth; m++) {
+		if (m === leapMonth) totalDays += getLunarLeapMonthDays(year);
+		totalDays += getLunarMonthDays(year, m);
+	}
+	if (month < 0) totalDays += getLunarMonthDays(year, absMonth);
+	totalDays += day - 1;
+	solarDate.setDate(solarDate.getDate() + totalDays);
+	return {
+		year: solarDate.getFullYear(),
+		month: solarDate.getMonth() + 1,
+		day: solarDate.getDate()
+	};
+}
+const lunarYearNames = [
+	"零",
+	"一",
+	"二",
+	"三",
+	"四",
+	"五",
+	"六",
+	"七",
+	"八",
+	"九",
+	"十"
+];
+/**
+* 将阿拉伯数字的年份转为汉字数字年份
+*/
+function getLunarYearName(year) {
+	return String(year).split("").map((item) => lunarYearNames[+item]).join("") + "年";
+}
+const lunarMonthNames = [
+	"正",
+	"二",
+	"三",
+	"四",
+	"五",
+	"六",
+	"七",
+	"八",
+	"九",
+	"十",
+	"冬",
+	"腊"
+];
+/**
+* 获取农历月份名称，月份从1开始，例如：正月，十月，腊月。
+*/
+function getLunarMonthName(month, isLeapMonth) {
+	return (isLeapMonth ? "闰" : "") + lunarMonthNames[month - 1] + "月";
+}
+const lunarDayNames = [
+	"初一",
+	"初二",
+	"初三",
+	"初四",
+	"初五",
+	"初六",
+	"初七",
+	"初八",
+	"初九",
+	"初十",
+	"十一",
+	"十二",
+	"十三",
+	"十四",
+	"十五",
+	"十六",
+	"十七",
+	"十八",
+	"十九",
+	"二十",
+	"廿一",
+	"廿二",
+	"廿三",
+	"廿四",
+	"廿五",
+	"廿六",
+	"廿七",
+	"廿八",
+	"廿九",
+	"三十"
+];
+/**
+* 获取农历日期名称，例如：初一，十二，廿一。
+*/
+function getLunarDayName(day) {
+	return lunarDayNames[day - 1];
+}
+const heavenlyStems = [
+	"甲",
+	"乙",
+	"丙",
+	"丁",
+	"戊",
+	"己",
+	"庚",
+	"辛",
+	"壬",
+	"癸"
+];
+const earthlyBranches = [
+	"子",
+	"丑",
+	"寅",
+	"卯",
+	"辰",
+	"巳",
+	"午",
+	"未",
+	"申",
+	"酉",
+	"戌",
+	"亥"
+];
+/**
+* 获取农历时辰名称，例如：子初、子正、午初，午正。
+*/
+function getLunarHourName(hour) {
+	const index = Math.floor(((hour === 23 ? 0 : hour) + 1) / 2) % 12;
+	return earthlyBranches[index] + (hour % 2 === 1 ? "初" : "正");
+}
+//#endregion
+export { baseLunarYear, earthlyBranches, formatDate, getDayOfYear, getDaysAfterLastDay, getDaysBeforeFirstDay, getDaysInMonth, getDaysSinceUnixEpoch, getFirstDayWeekday, getLunarDayName, getLunarHourName, getLunarLeapMonth, getLunarLeapMonthDays, getLunarMonthDays, getLunarMonthName, getLunarYearDays, getLunarYearName, getNextMonthDate, getNextMonthHeadDays, getPrevMonthDate, getPrevMonthTailDays, heavenlyStems, isLeapYear, lunarDayNames, lunarInfo, lunarMonthNames, lunarToSolar, lunarYearNames, minmaxDate, parseDate, solarToLunar, springFestivals, toDate, toDateNumber, toDateString, toMonthNumber };