@ivujs/i-utils 2.0.0 → 2.1.1

package/dist/es/date/index.mjs

@@ -1,82 +1,105 @@
-import { isNull, isString, isDate, isInteger } from '../validate/index.mjs';
+import { isNull, isString, isInteger, isDate } from '../validate/index.mjs';
 import { parseInt } from '../number/index.mjs';
 import { DATE } from '../constants/date.mjs';
 
+/**
+ * @module 日期
+ */
 /* 快捷日期 */
 /**
  * 今天
- *@returns {String} 返回日期字符串
+ *@returns {string} 返回日期字符串
  */
 function today() {
     return getDate();
 }
 /**
  * 昨天
- * @returns {String} 返回日期字符串
+ * @returns {string} 返回日期字符串
  */
 function yesterday() {
-    return formatDate(addDate(new Date(), -1));
+    return toDateString(addDate(new Date(), -1));
 }
 /**
  * 明天
- *@returns {String} 返回日期字符串
+ *@returns {string} 返回日期字符串
  */
 function tomorrow() {
-    return formatDate(addDate(new Date(), 1));
+    return toDateString(addDate(new Date(), 1));
 }
 /**
  * 上周（7天前日期）
  * @param {Date} date 日期参数，默认当前日期
- * @returns {String} 返回日期字符串
+ * @returns {string} 返回日期字符串
  */
 function lastWeek(date = new Date()) {
-    return formatDate(addDate(date, -7));
+    return toDateString(addDate(date, -7));
 }
 /**
  * 下周（7天后日期）
  * @param {Date} date 日期参数，默认当前日期
- * @returns {String} 返回日期字符串
+ * @returns {string} 返回日期字符串
  */
 function nextWeek(date = new Date()) {
-    return formatDate(addDate(date, 7));
+    return toDateString(addDate(date, 7));
 }
 /**
  * 上个月（30天前日期）
  * @param {Date} date 日期参数，默认当前日期
- * @returns {String} 返回日期字符串
+ * @returns {string} 返回日期字符串
  */
 function lastMonth(date = new Date()) {
-    return formatDate(addDate(date, -30));
+    const newDate = addMonth(date, -1);
+    // 处理跨月边界
+    if (newDate.getMonth() === date.getMonth()) {
+        newDate.setDate(0);
+    }
+    return toDateString(newDate);
 }
 /**
  * 下个月（30天后日期）
  * @param {Date} date 日期参数，默认当前日期
- * @returns {String} 返回日期字符串
+ * @returns {string} 返回日期字符串
  */
 function nextMonth(date = new Date()) {
-    return formatDate(addDate(date, 30));
+    const newDate = addMonth(date, 1);
+    // 处理跨月边界
+    if (newDate.getMonth() === date.getMonth()) {
+        newDate.setDate(0);
+    }
+    return toDateString(newDate);
 }
 /**
  * 上一年（365天前日期）
  * @param {Date} date 日期参数，默认当前日期
- * @returns {String} 返回日期字符串
+ * @returns {string} 返回日期字符串
  */
 function lastYear(date = new Date()) {
-    return formatDate(addDate(date, -365));
+    const newDate = addYear(date, -1);
+    // 处理跨年边界，闰年2月29日→平年2月28日
+    if (newDate.getMonth() !== date.getMonth() || newDate.getDate() !== date.getDate()) {
+        newDate.setDate(28);
+    }
+    return toDateString(newDate);
 }
 /**
  * 下一年（365天后日期）
  * @param {Date} date 日期参数，默认当前日期
- * @returns {String} 返回日期字符串
+ * @returns {string} 返回日期字符串
  */
 function nextYear(date = new Date()) {
-    return formatDate(addDate(date, 365));
+    const newDate = addYear(date, 1);
+    // 处理跨年边界，闰年2月29日→平年2月28日
+    if (newDate.getMonth() !== date.getMonth() || newDate.getDate() !== date.getDate()) {
+        newDate.setDate(28);
+    }
+    return toDateString(newDate);
 }
 /* 判断当前日期 */
 /**
  * 是否为上午
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isAM(date = new Date()) {
     return date.getHours() < 12;
@@ -84,7 +107,7 @@ function isAM(date = new Date()) {
 /**
  * 是否为下午
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isPM(date = new Date()) {
     return date.getHours() >= 12;
@@ -92,88 +115,88 @@ function isPM(date = new Date()) {
 /**
  * 是否为今天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isToday(date = new Date()) {
     // 此刻日期
-    let nowDate = new Date();
+    const nowDate = new Date();
     // 判断日期
-    return ["getFullYear", "getMonth", "getDate"].every((i) => nowDate[i]() === date[i]());
+    return ["getFullYear", "getMonth", "getDate"].every((item) => nowDate[item]() === date[item]());
 }
 /**
  * 是否为昨天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isYesterday(date = new Date()) {
     // 计算时间差
-    let startTime = date.getTime();
-    let nowTime = Date.now();
-    let diffTime = nowTime - startTime;
-    let diffDay = parseInt(diffTime / (1000 * 60 * 60 * 24));
+    const startTime = date.getTime();
+    const nowTime = Date.now();
+    const diffTime = nowTime - startTime;
+    const diffDay = parseInt(diffTime / (1000 * 60 * 60 * 24));
     return diffDay === 1;
 }
 /**
  * 是否为前天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isBeforeYesterday(date = new Date()) {
     // 计算时间差
-    let startTime = date.getTime();
-    let nowTime = Date.now();
-    let diffTime = nowTime - startTime;
-    let diffDay = parseInt(diffTime / (1000 * 60 * 60 * 24));
+    const startTime = date.getTime();
+    const nowTime = Date.now();
+    const diffTime = nowTime - startTime;
+    const diffDay = parseInt(diffTime / (1000 * 60 * 60 * 24));
     return diffDay === 2;
 }
 /**
  * 是否为明天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isTomorrow(date = new Date()) {
     // 计算时间差
-    let startTime = date.getTime();
-    let nowTime = Date.now();
-    let diffTime = startTime - nowTime;
-    let diffDay = parseInt(diffTime / (1000 * 60 * 60 * 24));
+    const startTime = date.getTime();
+    const nowTime = Date.now();
+    const diffTime = startTime - nowTime;
+    const diffDay = parseInt(diffTime / (1000 * 60 * 60 * 24));
     return diffDay === 1;
 }
 /**
  * 是否为后天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isAfterTomorrow(date = new Date()) {
     // 计算时间差
-    let startTime = date.getTime();
-    let nowTime = Date.now();
-    let time = startTime - nowTime;
-    let diffDay = parseInt(time / (1000 * 60 * 60 * 24));
+    const startTime = date.getTime();
+    const nowTime = Date.now();
+    const time = startTime - nowTime;
+    const diffDay = parseInt(time / (1000 * 60 * 60 * 24));
     return diffDay === 2;
 }
 /**
  * 是否为工作日
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isWorkday(date = new Date()) {
-    let dayOfWeek = getDayOfWeek(date);
+    const dayOfWeek = getDayOfWeek(date);
     return dayOfWeek !== 6 && dayOfWeek !== 7;
 }
 /**
  * 是否为周末（周六和周日）
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isWeekend(date = new Date()) {
-    let dayOfWeek = getDayOfWeek(date);
+    const dayOfWeek = getDayOfWeek(date);
     return dayOfWeek === 6 || dayOfWeek === 7;
 }
 /**
  * 是否为本周第一天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isFirstDayOfWeek(date = new Date()) {
     return getDayOfWeek(date) === 1;
@@ -181,7 +204,7 @@ function isFirstDayOfWeek(date = new Date()) {
 /**
  * 是否为本周最后一天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isLastDayOfWeek(date = new Date()) {
     return getDayOfWeek(date) === 7;
@@ -189,7 +212,7 @@ function isLastDayOfWeek(date = new Date()) {
 /**
  * 是否为本月第一天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isFirstDayOfMonth(date = new Date()) {
     return getDayOfMonth(date) === 1;
@@ -197,7 +220,7 @@ function isFirstDayOfMonth(date = new Date()) {
 /**
  * 是否为本月最后一天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isLastDayOfMonth(date = new Date()) {
     return getDayOfMonth(date) === getDaysOfMonth(date);
@@ -205,7 +228,7 @@ function isLastDayOfMonth(date = new Date()) {
 /**
  * 是否为本年第一天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isFirstDayOfYear(date = new Date()) {
     return getDayOfYear(date) === 1;
@@ -213,7 +236,7 @@ function isFirstDayOfYear(date = new Date()) {
 /**
  * 是否为本年最后一天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isLastDayOfYear(date = new Date()) {
     return getDayOfYear(date) === getDaysOfYear(date);
@@ -223,17 +246,17 @@ function isLastDayOfYear(date = new Date()) {
  * 是否为闰年
  * @description 闰年366天，平年365天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isLeapYear(date = new Date()) {
-    let year = date.getFullYear();
+    const year = date.getFullYear();
     return (year % 100 !== 0 && year % 4 === 0) || year % 400 === 0;
 }
 /**
  * 是否为平年
  * @description 闰年366天，平年365天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isCommonYear(date = new Date()) {
     return !isLeapYear(date);
@@ -243,26 +266,26 @@ function isCommonYear(date = new Date()) {
  * 是否在日期之前
  * @param {Date} startDate 开始日期
  * @param {Date} endDate 结束日期，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isBefore(startDate, endDate = new Date()) {
     // 计算时间差
-    let startTime = startDate.getTime();
-    let endTime = endDate.getTime();
-    let diffTime = startTime - endTime;
+    const startTime = startDate.getTime();
+    const endTime = endDate.getTime();
+    const diffTime = startTime - endTime;
     return diffTime < 0;
 }
 /**
  * 是否在日期之后
  * @param {Date} startDate 开始日期
  * @param {Date} endDate 结束日期，默认当前日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isAfter(startDate, endDate = new Date()) {
     // 计算时间差
-    let startTime = startDate.getTime();
-    let endTime = endDate.getTime();
-    let diffTime = startTime - endTime;
+    const startTime = startDate.getTime();
+    const endTime = endDate.getTime();
+    const diffTime = startTime - endTime;
     return diffTime > 0;
 }
 /**
@@ -270,12 +293,12 @@ function isAfter(startDate, endDate = new Date()) {
  * @param {Date} date 要比较的日期
  * @param {Date} startDate 开始日期
  * @param {Date} endDate 结束日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isBetween(date, startDate, endDate) {
-    let time = date.getTime();
-    let startTime = startDate.getTime();
-    let endTime = endDate.getTime();
+    const time = date.getTime();
+    const startTime = startDate.getTime();
+    const endTime = endDate.getTime();
     return time > startTime && time < endTime;
 }
 /* 日期是否相同 */
@@ -283,46 +306,46 @@ function isBetween(date, startDate, endDate) {
  * 两个日期是否为同一天
  * @param {Date} startDate 开始日期
  * @param {Date} endDate 结束日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isSame(startDate, endDate) {
-    return ["getFullYear", "getMonth", "getDate"].every((i) => startDate[i]() === endDate[i]());
+    return ["getFullYear", "getMonth", "getDate"].every((item) => startDate[item]() === endDate[item]());
 }
 /**
  * 两个日期是否为同一周
  * @param {Date} startDate 开始日期
  * @param {Date} endDate 结束日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isSameWeek(startDate, endDate) {
-    let diffDate1 = startDate.getTime() / (24 * 60 * 60 * 1000);
-    let diffDate2 = endDate.getTime() / (24 * 60 * 60 * 1000);
+    const diffDate1 = startDate.getTime() / (24 * 60 * 60 * 1000);
+    const diffDate2 = endDate.getTime() / (24 * 60 * 60 * 1000);
     return parseInt((diffDate1 + 4) / 7) === parseInt((diffDate2 + 4) / 7);
 }
 /**
  * 两个日期是否为同一个月
  * @param {Date} startDate 开始日期
  * @param {Date} endDate 结束日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isSameMonth(startDate, endDate) {
-    return ["getFullYear", "getMonth"].every((i) => startDate[i]() === endDate[i]());
+    return ["getFullYear", "getMonth"].every((item) => startDate[item]() === endDate[item]());
 }
 /**
  * 两个日期是否为同一年
  * @param {Date} startDate 开始日期
  * @param {Date} endDate 结束日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isSameYear(startDate, endDate) {
-    return ["getFullYear"].every((i) => startDate[i]() === endDate[i]());
+    return ["getFullYear"].every((item) => startDate[item]() === endDate[item]());
 }
 /* 比较两个日期相同 或 之前/之后 */
 /**
  * 两个日期是否相同或之前
  * @param {Date} startDate 开始日期
  * @param {Date} endDate 结束日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isSameOrBefore(startDate, endDate) {
     return isSame(startDate, endDate) || isBefore(startDate, endDate);
@@ -331,7 +354,7 @@ function isSameOrBefore(startDate, endDate) {
  * 两个日期是否相同或之后
  * @param {Date} startDate 开始日期
  * @param {Date} endDate 结束日期
- * @returns {Boolean} 返回结果
+ * @returns {boolean} 返回结果
  */
 function isSameOrAfter(startDate, endDate) {
     return isSame(startDate, endDate) || isAfter(startDate, endDate);
@@ -347,25 +370,27 @@ function getNow() {
 /**
  * 获得当前日期字符串
  * @param {Date} date 日期参数，默认当前日期
- * @param {String} format 日期字符串格式
- * @returns {String} 返回日期字符串
+ * @param options 配置项 配置项
+ * @returns {string} 返回日期字符串
  */
-function getDate(date = new Date(), format = "yyyy-MM-dd") {
-    return formatDate(date, format);
+function getDate(date = new Date(), options = { format: "yyyy-MM-dd" }) {
+    const { format } = options;
+    return toDateString(date, { format });
 }
 /**
  * 获得当前日期时间字符串
  * @param {Date} date 日期参数，默认当前日期
- * @param {String} format 日期时间字符串格式
- * @returns {String} 返回日期时间字符串
+ * @param options 配置项 配置项
+ * @returns {string} 返回日期时间字符串
  */
-function getDateTime(date = new Date(), format = "yyyy-MM-dd HH:mm:ss") {
-    return formatDate(date, format);
+function getDateTime(date = new Date(), options = { format: "yyyy-MM-dd HH:mm:ss" }) {
+    const { format } = options;
+    return toDateString(date, { format });
 }
 /**
  * 获取当前时间戳
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Number} 返回时间戳
+ * @returns {number} 返回时间戳
  */
 function getTimestamp(date = new Date()) {
     return date.getTime();
@@ -373,10 +398,10 @@ function getTimestamp(date = new Date()) {
 /**
  * 获取当前Unix时间戳
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Number} 返回Unix时间戳
+ * @returns {number} 返回Unix时间戳
  */
 function getUnixTimestamp(date = new Date()) {
-    return Math.round(date / 1000);
+    return Math.round(date.getTime() / 1000);
 }
 /**
  * 获得当前日期的对象形式
@@ -405,11 +430,11 @@ function getDateArray(date = new Date()) {
 /**
  * 获得当前日期是周几
  * @param {Date} date 日期参数，默认当前日期
- * @param {String} format 周格式化结果：E：如“日”，EE：如“周日”, EEE：如“星期日”；默认为E，为空则返回数字
- * @param {String} lang 语言zh和en，默认zh
- * @returns {Number,String} 返回周几，会根据语言返回
+ * @param options 配置项
+ * @returns {number|string} 返回周几，会根据语言返回
  */
-function getWeek(date = new Date(), format = "E", lang = "zh") {
+function getWeek(date = new Date(), options = { format: "E", lang: "zh" }) {
+    const { format, lang = "zh" } = options;
     // 根据格式化和语言返回对应的周
     if (format === "E") {
         return DATE.WEEK[lang].MINI[date.getDay()];
@@ -427,13 +452,13 @@ function getWeek(date = new Date(), format = "E", lang = "zh") {
 /**
  * 获得当前日期是第几季度
  * @param {Date} date 日期参数，默认当前日期
- * @param {String} format 季度格式化结果：Q：如“一”, QQ：如“一季度”；QQQ：如“第一季度”；默认为Q，为空则返回数字
- * @param {String} lang 语言zh和en，默认zh
- * @returns {Number,String} 返回第几季度，会根据语言返回
+ * @param options 配置项
+ * @returns {number|string} 返回第几季度，会根据语言返回
  */
-function getQuarter(date = new Date(), format = "Q", lang = "zh") {
+function getQuarter(date = new Date(), options = { format: "Q", lang: "zh" }) {
+    const { format, lang = "zh" } = options;
     // 根据格式化和语言返回对应的周
-    let quarterNum = Number(Math.floor((date.getMonth() + 3) / 3));
+    const quarterNum = Number(Math.floor((date.getMonth() + 3) / 3));
     if (format === "Q") {
         return DATE.QUARTER[lang].MINI[quarterNum - 1];
     }
@@ -451,7 +476,7 @@ function getQuarter(date = new Date(), format = "Q", lang = "zh") {
 /**
  * 获得当前日期是所在周的第几天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Number|String} 返回天数
+ * @returns {number|string} 返回天数
  */
 function getDayOfWeek(date = new Date()) {
     return [7, 1, 2, 3, 4, 5, 6][date.getDay()];
@@ -459,7 +484,7 @@ function getDayOfWeek(date = new Date()) {
 /**
  * 获得当前日期是所在月的第几天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Number} 返回天数
+ * @returns {number} 返回天数
  */
 function getDayOfMonth(date = new Date()) {
     return date.getDate();
@@ -467,44 +492,43 @@ function getDayOfMonth(date = new Date()) {
 /**
  * 获得当前日期是所在年的第几天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Number} 返回天数
+ * @returns {number} 返回天数
  */
 function getDayOfYear(date = new Date()) {
-    return Math.ceil((date - new Date(date.getFullYear().toString())) / (24 * 60 * 60 * 1000)) + 1;
+    return Math.ceil((date.getTime() - new Date(date.getFullYear().toString()).getTime()) / (24 * 60 * 60 * 1000)) + 1;
 }
 /* 当前日期的周是所在 月/年 的第几周 */
 /**
  * 获得当前日期是所在月的第几周
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Number} 返回周数
+ * @returns {number} 返回周数
  */
 function getWeekOfMonth(date = new Date()) {
-    return Math.ceil((date.getDate() + 6 - getDayOfWeek(date)) / 7);
+    return Math.ceil((date.getDate() + 6 - Number(getDayOfWeek(date))) / 7);
 }
 /**
  * 获得当前日期是所在年的第几周
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Number} 返回周数
+ * @returns {number} 返回周数
  */
 function getWeekOfYear(date = new Date()) {
-    let startDate = new Date(date.getFullYear(), 0, 1);
-    let startDay = getDayOfWeek(startDate);
-    let diff = Math.round((date - startDate) / (24 * 60 * 60 * 1000));
-    return Math.ceil((diff + startDay) / 7);
+    const startDate = new Date(date.getFullYear(), 0, 1);
+    const startDay = getDayOfWeek(startDate);
+    const diff = Math.round((date.getTime() - startDate.getTime()) / (24 * 60 * 60 * 1000));
+    return Math.ceil((diff + Number(startDay)) / 7);
 }
 /* 当前日期所在 周/月/年 共几天 */
 /**
  * 获得当前日期所在的周共几天
- * @param {Date} date 日期参数，默认当前日期
- * @returns {Number} 返回天数
+ * @returns {number} 返回天数
  */
-function getDaysOfWeek(date = new Date()) {
+function getDaysOfWeek() {
     return 7;
 }
 /**
  * 获得当前日期所在的月共几天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Number} 返回天数
+ * @returns {number} 返回天数
  */
 function getDaysOfMonth(date = new Date()) {
     return new Date(date.getFullYear(), date.getMonth() + 1, 0).getDate();
@@ -512,7 +536,7 @@ function getDaysOfMonth(date = new Date()) {
 /**
  * 获得当前日期所在的年共几天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Number} 返回天数
+ * @returns {number} 返回天数
  */
 function getDaysOfYear(date = new Date()) {
     return isLeapYear(date) ? 366 : 365;
@@ -521,12 +545,12 @@ function getDaysOfYear(date = new Date()) {
 /**
  * 获得当前日期是所在月的第几周
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Number} 返回周数
+ * @returns {number} 返回周数
  */
 function getWeeksOfMonth(date = new Date()) {
-    let startDate = new Date(date.getFullYear(), 0, 1);
-    let startDay = getDayOfWeek(startDate);
-    let fullDays = isLeapYear(date) ? 366 : 365;
+    const startDate = new Date(date.getFullYear(), 0, 1);
+    const startDay = Number(getDayOfWeek(startDate));
+    const fullDays = isLeapYear(date) ? 366 : 365;
     if (startDay === 1) {
         return Math.ceil(fullDays / 7);
     }
@@ -537,12 +561,12 @@ function getWeeksOfMonth(date = new Date()) {
 /**
  * 获得当前日期是所在年的第几周
  * @param {Date} date 日期参数，默认当前日期
- * @returns {Number} 返回周数
+ * @returns {number} 返回周数
  */
 function getWeeksOfYear(date = new Date()) {
-    let startDate = new Date(date.getFullYear(), 0, 1);
-    let startDay = getDayOfWeek(startDate);
-    let fullDays = isLeapYear(date) ? 366 : 365;
+    const startDate = new Date(date.getFullYear(), 0, 1);
+    const startDay = Number(getDayOfWeek(startDate));
+    const fullDays = isLeapYear(date) ? 366 : 365;
     if (startDay === 1) {
         return Math.ceil(fullDays / 7);
     }
@@ -554,101 +578,111 @@ function getWeeksOfYear(date = new Date()) {
 /**
  * 获得当前日期所在周的第一天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {String} 返回日期字符串
+ * @returns {string} 返回日期字符串
  */
 function getFirstDateOfWeek(date = new Date()) {
-    let weekDay = getDayOfWeek(date);
+    const weekDay = Number(getDayOfWeek(date));
     date.setDate(date.getDate() - weekDay + 1);
-    return formatDate(date);
+    return toDateString(date);
 }
 /**
  * 获得当前日期所在周的最后一天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {String} 返回日期字符串
+ * @returns {string} 返回日期字符串
  */
 function getLastDateOfWeek(date = new Date()) {
-    let weekDay = getDayOfWeek(date);
+    const weekDay = Number(getDayOfWeek(date));
     date.setDate(date.getDate() + (7 - weekDay));
-    return formatDate(date);
+    return toDateString(date);
 }
 /**
  * 获取当前日期所在周的所有日期
+ * @param {Date} date 日期参数，默认当前日期
+ * @returns {string[]} 返回日期数组
  */
 function getFullDateOfWeek(date = new Date()) {
-    let array = [];
+    const array = [];
     // 获得当前日期是本周几
-    let dayOfWeek = date.getDay();
+    const dayOfWeek = date.getDay();
     // 根据当前日期获取本周一
-    let firstDateOfWeek = new Date();
+    const firstDateOfWeek = new Date();
     firstDateOfWeek.setDate(date.getDate() - (dayOfWeek === 0 ? 6 : dayOfWeek - 1));
     // 遍历本周日期
     for (let i = 0; i < 7; i++) {
-        let currentDate = new Date(firstDateOfWeek);
+        const currentDate = new Date(firstDateOfWeek);
         currentDate.setDate(currentDate.getDate() + i);
-        array.push(formatDate(currentDate));
+        array.push(toDateString(currentDate));
     }
     return array;
 }
 /**
  * 获得当前日期所在月的第一天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {String} 返回日期字符串
+ * @returns {string} 返回日期字符串
  */
 function getFirstDateOfMonth(date = new Date()) {
     date.setDate(1);
-    return formatDate(date);
+    return toDateString(date);
 }
 /**
  * 获得当前日期所在月的最后一天
  * @param {Date} date 日期参数，默认当前日期
- * @returns {String} 返回日期字符串
+ * @returns {string} 返回日期字符串
  */
 function getLastDateOfMonth(date = new Date()) {
-    return formatDate(new Date(date.getFullYear(), date.getMonth() + 1, 0));
+    return toDateString(new Date(date.getFullYear(), date.getMonth() + 1, 0));
 }
 /**
  * 获取当前日期所在月的所有日期
+ * @param {Date} date 日期参数，默认当前日期
+ * @returns {string[]} 返回日期数组
  */
 function getFullDateOfMonth(date = new Date()) {
-    let array = [];
+    const array = [];
     // 获得本月第一天
-    let firstDateOfMonth = new Date(date.getFullYear(), date.getMonth(), 1);
+    const firstDateOfMonth = new Date(date.getFullYear(), date.getMonth(), 1);
     // 获得本月最后一天
-    let lastDateOfMonth = new Date(date.getFullYear(), date.getMonth() + 1, 0);
+    const lastDateOfMonth = new Date(date.getFullYear(), date.getMonth() + 1, 0);
     // 遍历本月日期
     for (let i = 0; i < lastDateOfMonth.getDate(); i++) {
-        let currentDate = new Date(firstDateOfMonth);
+        const currentDate = new Date(firstDateOfMonth);
         currentDate.setDate(firstDateOfMonth.getDate() + i);
-        array.push(currentDate);
+        array.push(toDateString(currentDate));
     }
     return array;
 }
 /**
  * 获取当前日期所在年的第一天
+ * @param {Date} date 日期参数，默认当前日期
+ * @returns {string} 返回日期字符串
  */
 function getFirstDateOfYear(date = new Date()) {
-    return new Date(date.getFullYear(), 0, 1);
+    return toDateString(new Date(date.getFullYear(), 0, 1));
 }
 /**
  * 获取当前日期所在年的最后一天
+ * @param {Date} date 日期参数，默认当前日期
+ * @returns {string} 返回日期字符串
  */
 function getLastDateOfYear(date = new Date()) {
-    return new Date(date.getFullYear(), 11, 31);
+    return toDateString(new Date(date.getFullYear(), 11, 31));
 }
 /**
  * 获取当前日期所在年的所有日期
+ * @param {Date} date 日期参数，默认当前日期
+ * @returns {string} 返回日期字符串
  */
 function getFullDateOfYear(date = new Date()) {
-    let array = [];
+    const array = [];
     // 获得本年第一天
-    let firstDateOfYear = new Date(date.getFullYear(), 0, 1);
+    const firstDateOfYear = new Date(date.getFullYear(), 0, 1);
     // 获得本年一共多少天
-    let daysOfYear = getDaysOfYear();
+    const daysOfYear = getDaysOfYear();
     // 遍历本年日期
     for (let i = 0; i < daysOfYear; i++) {
-        let currentDate = new Date(firstDateOfYear);
+        const currentDate = new Date(firstDateOfYear);
         currentDate.setDate(firstDateOfYear.getDate() + i);
-        array.push(currentDate.toLocaleDateString());
+        array.push(toDateString(currentDate));
     }
     return array;
 }
@@ -657,12 +691,12 @@ function getFullDateOfYear(date = new Date()) {
  * 计算两个日期相差的天数，不满一天为0
  * @param {Date} startDate 开始日期
  * @param {Date} endDate 结束日期
- * @returns {Number} 返回两个日期相差的天数，结果为正数或者负数
+ * @returns {number} 返回两个日期相差的天数，结果为正数或者负数
  */
 function getDiffDay(startDate, endDate) {
     if (isNull(startDate) || isNull(endDate))
         return 0;
-    let diff = (endDate - startDate) / (24 * 60 * 60 * 1000);
+    const diff = (endDate.getTime() - startDate.getTime()) / (24 * 60 * 60 * 1000);
     // 返回
     return diff >= 0 ? Math.abs(diff) : diff;
 }
@@ -670,12 +704,12 @@ function getDiffDay(startDate, endDate) {
  * 计算两个日期相差的周数，不满一周为0
  * @param {Date} startDate 开始日期
  * @param {Date} endDate 结束日期
- * @returns {Number} 返回两个日期相差的周数，结果为正数或者负数
+ * @returns {number} 返回两个日期相差的周数，结果为正数或者负数
  */
 function getDiffWeek(startDate, endDate) {
     if (isNull(startDate) || isNull(endDate))
         return 0;
-    let diff = (endDate - startDate) / (7 * 24 * 60 * 60 * 1000);
+    const diff = (endDate.getTime() - startDate.getTime()) / (7 * 24 * 60 * 60 * 1000);
     // 返回
     return diff >= 0 ? Math.abs(diff) : diff;
 }
@@ -683,12 +717,12 @@ function getDiffWeek(startDate, endDate) {
  * 计算两个日期相差的月数，不满一月为0
  * @param {Date} startDate 开始日期
  * @param {Date} endDate 结束日期
- * @returns {Number} 返回两个日期相差的月数，结果为正数或者负数
+ * @returns {number} 返回两个日期相差的月数，结果为正数或者负数
  */
 function getDiffMonth(startDate, endDate) {
     if (isNull(startDate) || isNull(endDate))
         return 0;
-    let diff = (startDate - endDate) / (30 * 24 * 60 * 60 * 1000);
+    const diff = (startDate.getTime() - endDate.getTime()) / (30 * 24 * 60 * 60 * 1000);
     // 返回
     return diff >= 0 ? Math.abs(diff) : diff;
 }
@@ -696,12 +730,12 @@ function getDiffMonth(startDate, endDate) {
  * 计算两个日期相差的年数，不满一年为0
  * @param {Date} startDate 开始日期
  * @param {Date} endDate 结束日期
- * @returns {Number} 返回两个日期相差的年数，结果为正数或者负数
+ * @returns {number} 返回两个日期相差的年数，结果为正数或者负数
  */
 function getDiffYear(startDate, endDate) {
     if (isNull(startDate) || isNull(endDate))
         return 0;
-    let diff = (endDate - startDate) / (12 * 30 * 24 * 60 * 60 * 1000);
+    const diff = (endDate.getTime() - startDate.getTime()) / (12 * 30 * 24 * 60 * 60 * 1000);
     // 返回
     return diff >= 0 ? Math.abs(diff) : diff;
 }
@@ -716,9 +750,9 @@ function getBetweenDates(startDate, endDate) {
     if (isNull(startDate) || isNull(endDate))
         return [];
     // 计算
-    let array = [];
-    while (endDate - startDate >= 0) {
-        let year = startDate.getFullYear(), month = _digit(startDate.getMonth() + 1), day = _digit(startDate.getDate());
+    const array = [];
+    while (endDate.getTime() - startDate.getTime() >= 0) {
+        const year = startDate.getFullYear(), month = _digit(startDate.getMonth() + 1), day = _digit(startDate.getDate());
         // 加入数组
         array.push(year + "-" + month + "-" + day);
         // 更新日期
@@ -737,22 +771,22 @@ function getBetweenMonths(startDate, endDate) {
     if (isNull(startDate) || isNull(endDate))
         return [];
     // 计算
-    let array = [];
+    const array = [];
     // 获取时间对象
-    let min = new Date();
-    let max = new Date();
+    const min = new Date();
+    const max = new Date();
     // 设置起始时间
     min.setFullYear(startDate.getFullYear(), startDate.getMonth() + 1);
     // 设置结束时间
     max.setFullYear(endDate.getFullYear(), endDate.getMonth() + 1);
     // 复制一份起始时间对象
-    let curr = min;
+    const curr = min;
     // 定义字符串
     let str = "";
     // 起始时间在结束时间之前
     while (curr <= max) {
         // 获取此时间的月份
-        let month = curr.getMonth();
+        const month = curr.getMonth();
         // 如果月份为0，也就是代表12月份
         if (month === 0) {
             str = curr.getFullYear() - 1 + "-" + 12;
@@ -778,9 +812,9 @@ function getBetweenYears(startDate, endDate) {
     if (isNull(startDate) || isNull(endDate))
         return [];
     // 计算
-    let array = [];
-    while (endDate - startDate >= 0) {
-        let year = startDate.getFullYear();
+    const array = [];
+    while (endDate.getTime() - startDate.getTime() >= 0) {
+        const year = startDate.getFullYear();
         // 加入数组
         array.push(year);
         // 更新日期
@@ -793,22 +827,23 @@ function getBetweenYears(startDate, endDate) {
  * 获得过去时间的字符串显示
  * @description 例如：刚刚，1分钟前，1小时前等
  * @param {Date} date 日期参数
- * @param {String} lang 语言zh和en，默认zh
- * @returns {String} 返回字符串
+ * @param options 配置项
+ * @returns {string} 返回字符串
  */
-function getPastTime(date, lang = "zh") {
+function getPastTime(date, options = { lang: "zh" }) {
+    const { lang = "zh" } = options;
     if (isNull(date))
         return "--";
     // 计算时间差
-    let startTime = date.getTime();
-    let currentTime = Date.now();
-    let time = currentTime - startTime;
+    const startTime = date.getTime();
+    const currentTime = Date.now();
+    const time = currentTime - startTime;
     // 年月日时分
-    let year = parseInt(time / (1000 * 60 * 60 * 24 * 30 * 12));
-    let month = parseInt(time / (1000 * 60 * 60 * 24 * 30));
-    let day = parseInt(time / (1000 * 60 * 60 * 24));
-    let hour = parseInt(time / (1000 * 60 * 60));
-    let min = parseInt(time / (1000 * 60));
+    const year = parseInt(time / (1000 * 60 * 60 * 24 * 30 * 12));
+    const month = parseInt(time / (1000 * 60 * 60 * 24 * 30));
+    const day = parseInt(time / (1000 * 60 * 60 * 24));
+    const hour = parseInt(time / (1000 * 60 * 60));
+    const min = parseInt(time / (1000 * 60));
     // 返回结果
     if (year) {
         return year + DATE.PASS_TIME[lang].YEAR;
@@ -846,15 +881,16 @@ function getPastTime(date, lang = "zh") {
  * 获得剩余时间的字符串显示
  * @description 例如：1天10小时20分钟30秒
  * @param {Date} date 日期参数
- * @param {String} lang 语言zh和en，默认zh
- * @returns {String} 返回字符串
+ * @param options 配置项
+ * @returns {string} 返回字符串
  */
-function getOverTime(date, lang = "zh") {
+function getOverTime(date, options = { lang: "zh" }) {
+    const { lang = "zh" } = options;
     if (isNull(date))
         return "--";
     // 计算
-    let startDate = new Date(); // 开始时间
-    let t = date.getTime() - startDate.getTime(); // 时间差
+    const startDate = new Date(); // 开始时间
+    const t = date.getTime() - startDate.getTime(); // 时间差
     let d = 0, h = 0, m = 0, s = 0;
     if (t >= 0) {
         d = Math.floor(t / 1000 / 3600 / 24);
@@ -868,23 +904,23 @@ function getOverTime(date, lang = "zh") {
 /**
  * 通过日期获得年龄
  * @param {Date} date 日期参数
- * @returns {Number} 返回周岁年龄
+ * @returns {number} 返回周岁年龄
  */
 function getAge(date) {
     let age = 0;
     // 传参日期
-    let dateArray = formatDate(date).split("-");
-    let birthYear = Number(dateArray[0]);
-    let birthMonth = Number(dateArray[1]);
-    let birthDay = Number(dateArray[2]);
+    const dateArray = toDateString(date).split("-");
+    const birthYear = Number(dateArray[0]);
+    const birthMonth = Number(dateArray[1]);
+    const birthDay = Number(dateArray[2]);
     // 当前的日期
-    let nowDate = new Date();
-    let nowYear = nowDate.getFullYear(), nowMonth = nowDate.getMonth() + 1, nowDay = nowDate.getDate();
+    const nowDate = new Date();
+    const nowYear = nowDate.getFullYear(), nowMonth = nowDate.getMonth() + 1, nowDay = nowDate.getDate();
     // 出生年份需要小于当年，否则是0岁
-    let diffAge = nowYear - birthYear;
+    const diffAge = nowYear - birthYear;
     if (diffAge > 0) {
-        let diffMonth = nowMonth - birthMonth;
-        let diffDay = nowDay - birthDay;
+        const diffMonth = nowMonth - birthMonth;
+        const diffDay = nowDay - birthDay;
         if (diffMonth === 0) {
             if (diffDay < 0) {
                 age = diffAge - 1;
@@ -908,29 +944,31 @@ function getAge(date) {
 /**
  * 通过日期获得星座
  * @param {Date} date 日期参数
- * @param {String} lang 语言zh和en，默认zh
- * @returns {String} 返回星座
+ * @param options 配置项
+ * @returns {string} 返回星座
  */
-function getZodiac(date, lang = "zh") {
+function getZodiac(date, options = { lang: "zh" }) {
+    const { lang = "zh" } = options;
     if (isNull(date))
         return "";
     // 计算
-    let days = [20, 19, 21, 20, 21, 22, 23, 23, 23, 24, 23, 22];
-    let month = date.getMonth() + 1;
-    let day = date.getDate();
+    const days = [20, 19, 21, 20, 21, 22, 23, 23, 23, 24, 23, 22];
+    const month = date.getMonth() + 1;
+    const day = date.getDate();
     return day < days[month - 1] ? DATE.ZODIAC[lang][month - 1] : DATE.ZODIAC[lang][month];
 }
 /**
  * 通过日期获得生肖
  * @param {Date} date 日期参数
- * @param {String} lang 语言zh和en，默认zh
- * @returns {String} 返回生肖
+ * @param options 配置项
+ * @returns {string} 返回生肖
  */
-function getChineseZodiac(date, lang = "zh") {
+function getChineseZodiac(date, options = { lang: "zh" }) {
+    const { lang = "zh" } = options;
     if (isNull(date))
         return "";
     // 计算
-    let year = date.getFullYear();
+    const year = date.getFullYear();
     if (year < 1900) {
         return "未知";
     }
@@ -940,7 +978,7 @@ function getChineseZodiac(date, lang = "zh") {
 /**
  * 日期加减年
  * @param {Date} date 日期参数，默认当前日期
- * @param {Number} num 加减数量，用正数和负数表示；默认+1
+ * @param {number} num 加减数量，用正数和负数表示；默认+1
  * @returns {Date} 返回加减后的日期
  */
 function addYear(date = new Date(), num = 1) {
@@ -950,7 +988,7 @@ function addYear(date = new Date(), num = 1) {
 /**
  * 日期加减月
  * @param {Date} date 日期参数，默认当前日期
- * @param {Number} num 加减数量，用正数和负数表示；默认+1
+ * @param {number} num 加减数量，用正数和负数表示；默认+1
  * @returns {Date} 返回加减后的日期
  */
 function addMonth(date = new Date(), num = 1) {
@@ -960,7 +998,7 @@ function addMonth(date = new Date(), num = 1) {
 /**
  * 日期加减天
  * @param {Date} date 日期参数，默认当前日期
- * @param {Number} num 加减数量，用正数和负数表示；默认+1
+ * @param {number} num 加减数量，用正数和负数表示；默认+1
  * @returns {Date} 返回加减后的日期
  */
 function addDate(date = new Date(), num = 1) {
@@ -970,7 +1008,7 @@ function addDate(date = new Date(), num = 1) {
 /**
  * 日期加减小时
  * @param {Date} date 日期参数，默认当前日期
- * @param {Number} num 加减数量，用正数和负数表示；默认+1
+ * @param {number} num 加减数量，用正数和负数表示；默认+1
  * @returns {Date} 返回加减后的日期
  */
 function addHours(date = new Date(), num = 1) {
@@ -980,7 +1018,7 @@ function addHours(date = new Date(), num = 1) {
 /**
  * 日期加减分钟
  * @param {Date} date 日期参数，默认当前日期
- * @param {Number} num 加减数量，用正数和负数表示；默认+1
+ * @param {number} num 加减数量，用正数和负数表示；默认+1
  * @returns {Date} 返回加减后的日期
  */
 function addMinutes(date = new Date(), num = 1) {
@@ -990,7 +1028,7 @@ function addMinutes(date = new Date(), num = 1) {
 /**
  * 日期加减秒
  * @param {Date} date 日期参数，默认当前日期
- * @param {Number} num 加减数量，用正数和负数表示；默认+1
+ * @param {number} num 加减数量，用正数和负数表示；默认+1
  * @returns {Date} 返回加减后的日期
  */
 function addSeconds(date = new Date(), num = 1) {
@@ -1000,7 +1038,7 @@ function addSeconds(date = new Date(), num = 1) {
 /**
  * 日期加减毫秒
  * @param {Date} date 日期参数，默认当前日期
- * @param {Number} num 加减数量，用正数和负数表示；默认+100
+ * @param {number} num 加减数量，用正数和负数表示；默认+100
  * @returns {Date} 返回加减后的日期
  */
 function addMillisecond(date = new Date(), num = 100) {
@@ -1010,7 +1048,7 @@ function addMillisecond(date = new Date(), num = 100) {
 /**
  * 日期加减周
  * @param {Date} date 日期参数，默认当前日期
- * @param {Number} num 加减数量，用正数和负数表示；默认+1
+ * @param {number} num 加减数量，用正数和负数表示；默认+1
  * @returns {Date} 返回加减后的日期
  */
 function addWeek(date = new Date(), num = 1) {
@@ -1020,7 +1058,7 @@ function addWeek(date = new Date(), num = 1) {
 /**
  * 日期加减季度
  * @param {Date} date 日期参数，默认当前日期
- * @param {Number} num 加减数量，用正数和负数表示；默认+1
+ * @param {number} num 加减数量，用正数和负数表示；默认+1
  * @returns {Date} 返回加减后的日期
  */
 function addQuarter(date = new Date(), num = 1) {
@@ -1029,151 +1067,190 @@ function addQuarter(date = new Date(), num = 1) {
 }
 /* 格式化和解析日期 */
 /**
- * 日期对象转为日期字符串
- * @description 支持日期字符串，日期对象，时间戳，unix时间戳
- * @param {String|Date|Number} date 日期参数
- * @param {String} format 转化格式
- * @param {String} lang 语言zh和en，默认zh
- * @returns {String} 返回日期字符串
+ * UTC 日期对象转本地时区日期对象
+ * @description 将 UTC 时间的 Date 对象转换为本地时间的 Date 对象（时间戳不变，仅调整时区偏移）
+ * @param {Date} date UTC 日期对象，默认当前 UTC 时间
+ * @returns {Date} 本地时区日期对象（时间戳 = UTC时间戳 + 时区偏移毫秒数）
+ * @example
+ * // UTC时间：2025-01-26 00:00:00
+ * const utcDate = new Date('2025-01-26T00:00:00Z');
+ * const localDate = fromDateUTC(utcDate);
+ * console.log(toDateString(localDate)); // 2025-01-26 08:00:00（北京本地时间）
  */
-// TODO：需要支持"20260109" 这种格式的日期的转换
-function formatDate(date, format = "yyyy-MM-dd", lang = "zh") {
-    if (isNull(date))
-        return "";
-    // 是日期字符串
-    if (isString(date)) {
-        date = parseDate(date);
-    }
-    // 是日期对象
-    else if (isDate(date)) ;
-    // 是时间戳
-    else if (isInteger(date) && String(date).length === 13) {
-        date = new Date(date);
-    }
-    // 是unix时间戳
-    else if (isInteger(date) && String(date).length === 10) {
-        date = new Date(date * 1000);
-    }
-    // 不支持的日期格式
-    else {
-        console.error("Not supported date format!");
-        return date;
-    }
-    // 配置规则
-    let rules = {
-        "M+": date.getMonth() + 1, // 月份
-        "d+": date.getDate(), // 日
-        "h+": date.getHours() % 12 === 0 ? 12 : date.getHours() % 12, // 12小时制
-        "H+": date.getHours(), // 24小时制
-        "m+": date.getMinutes(), // 分钟
-        "s+": date.getSeconds(), // 秒
-        "S+": date.getMilliseconds(), // 毫秒
-        "a+": date.getHours() < 12 ? "am" : "pm", // 上午/下午，小写
-        "A+": date.getHours() < 12 ? "AM" : "PM", // 上午/下午，大写
-        "E+": date.getDay(), // 周
-        "Q+": Math.floor((date.getMonth() + 3) / 3), // 季度
-        S: date.getMilliseconds(), // 毫秒
-    };
-    // 年
-    let yearReg = new RegExp(/(y+)/g);
-    if (yearReg.test(format)) {
-        format = format.replace(yearReg, function (match, $1) {
-            return (date.getFullYear() + "").substring(4 - $1.length);
-        });
-    }
-    // 上午/下午
-    let amPmReg = new RegExp(/((b+)|(A+))/g);
-    if (amPmReg.test(format)) {
-        format = format.replace(amPmReg, function (match, $1) {
-            // AA或者aa为中文
-            if ($1.length > 1) {
-                return date.getHours() < 12 ? DATE.AM_PM[lang].AM : DATE.AM_PM[lang].PM;
-            }
-            // 其他为英文
-            else {
-                return $1 === $1.toLowerCase()
-                    ? date.getHours() < 12
-                        ? DATE.AM_PM["en"].AM.toLowerCase()
-                        : DATE.AM_PM["en"].PM.toLowerCase()
-                    : date.getHours() < 12
-                        ? DATE.AM_PM["en"].AM
-                        : DATE.AM_PM["en"].PM;
-            }
-        });
-    }
-    // 周
-    let weekReg = new RegExp(/(E+)/g);
-    if (weekReg.test(format)) {
-        format = format.replace(weekReg, function (match, $1) {
-            return $1.length === 1
-                ? DATE.WEEK[lang].MINI[date.getDay()]
-                : $1.length === 2
-                    ? DATE.WEEK[lang].SHORT[date.getDay()]
-                    : DATE.WEEK[lang].FULL[date.getDay()];
-        });
-    }
-    // 季度
-    let quarterReg = new RegExp(/(Q+)/g);
-    if (quarterReg.test(format)) {
-        format = format.replace(quarterReg, function (match, $1) {
-            return $1.length === 1
-                ? DATE.QUARTER[lang].MINI[Math.floor((date.getMonth() + 3) / 3) - 1]
-                : $1.length === 2
-                    ? DATE.QUARTER[lang].SHORT[Math.floor((date.getMonth() + 3) / 3) - 1]
-                    : DATE.QUARTER[lang].FULL[Math.floor((date.getMonth() + 3) / 3) - 1];
-        });
-    }
-    // 经过上面的过滤，剩余的日期参数处理
-    for (let k in rules) {
-        let dateReg = new RegExp("(" + k + ")");
-        if (dateReg.test(format)) {
-            format = format.replace(dateReg, function (match, $1) {
-                return $1.length === 1
-                    ? rules[k]
-                    : $1.length === 2
-                        ? ("00" + rules[k]).substring(("" + rules[k]).length)
-                        : ("000" + rules[k]).substring(("" + rules[k]).length);
-            });
-        }
-    }
-    return format;
+function fromDateUTC(date = new Date()) {
+    return new Date(date.getTime() - date.getTimezoneOffset() * 60 * 1000);
+}
+/**
+ * 本地时区日期转 UTC 日期对象
+ * @description 将本地时间的 Date 对象转换为 UTC 时间的 Date 对象（时间戳不变，仅调整时区偏移）
+ * @param {Date} date 本地日期对象，默认当前本地时间
+ * @returns {Date} UTC 日期对象（时间戳 = 本地时间戳 - 时区偏移毫秒数）
+ * @example
+ * // 北京本地时间：2025-01-26 08:00:00（东8区）
+ * const localDate = new Date('2025-01-26 08:00:00');
+ * const utcDate = toDateUTC(localDate);
+ * console.log(utcDate.toISOString()); // 2025-01-26T00:00:00.000Z（UTC时间）
+ */
+function toDateUTC(date = new Date()) {
+    return new Date(date.getTime() + date.getTimezoneOffset() * 60 * 1000);
+}
+/**
+ * 格式化日期为 UTC 字符串（符合 ISO 8601 标准）
+ * @description 直接输出 UTC 时间的字符串，无需手动转换时区
+ * @param {Date} date 本地日期对象，默认当前本地时间
+ * @param {DateOptions} options 格式化配置，默认 yyyy-MM-dd HH:mm:ss
+ * @returns {string} UTC 日期字符串
+ * @example
+ * const localDate = new Date('2025-01-26 08:00:00');
+ * console.log(toUTCString(localDate)); // 2025-01-26 00:00:00
+ */
+function toDataUTCString(date = new Date(), options = { format: "yyyy-MM-dd HH:mm:ss" }) {
+    const utcDate = toDateUTC(date);
+    return toDateString(utcDate, options);
 }
 /**
  * 日期字符串转为日期对象
  * @description 支持日期字符串，时间戳，Unix时间戳
- * @param {String|Number} value 日期参数
+ * @param {string|number} value 日期参数
  * @returns {Date} 返回日期对象
  */
-function parseDate(value) {
+function toDate(value) {
     if (isNull(value))
-        return null;
-    // 是日期字符串
-    if (isString(value)) {
-        return new Date(value.replace(/-/g, "/"));
+        return;
+    try {
+        // 是日期字符串
+        if (isString(value)) {
+            return new Date(String(value).replace(/-/g, "/"));
+        }
+        // 是时间戳
+        else if (isInteger(value) && String(value).length === 13) {
+            return new Date(value);
+        }
+        // 是unix时间戳
+        else if (isInteger(value) && String(value).length === 10) {
+            return new Date(Number(value) * 1000);
+        }
+        // 不支持的日期格式
+        else {
+            console.error("Not supported date format!");
+            return undefined;
+        }
     }
-    // 是时间戳
-    else if (isInteger(value) && String(value).length === 13) {
-        return new Date(value);
+    catch (e) {
+        console.error("Parse to Date error", e);
     }
-    // 是unix时间戳
-    else if (isInteger(value) && String(value).length === 10) {
-        return new Date(value * 1000);
+}
+/**
+ * 日期对象转为日期字符串
+ * @description 支持日期字符串，日期对象，时间戳，unix时间戳
+ * @param {Date} date 日期参数
+ * @param options 配置项
+ * @returns {string} 返回日期字符串
+ */
+function toDateString(date, options = { format: "yyyy-MM-dd", lang: "zh" }) {
+    const { format = "yyyy-MM-dd", lang = "zh" } = options;
+    if (isNull(date))
+        return "";
+    try {
+        // 判断是否是日期对象
+        if (!isDate(date)) {
+            console.error("Not a Date type!");
+            return "";
+        }
+        // 日期转化替换
+        const replaceRules = {
+            // 年（yyyy/yy）
+            "(y+)": (match) => {
+                const year = date.getFullYear().toString();
+                return match.length === 2 ? year.slice(-2) : year;
+            },
+            // 月（M/MM）
+            "(M+)": (match) => {
+                const month = date.getMonth() + 1;
+                return match.length === 1 ? month.toString() : month.toString().padStart(2, "0");
+            },
+            // 日（d/dd）
+            "(d+)": (match) => {
+                const day = date.getDate();
+                return match.length === 1 ? day.toString() : day.toString().padStart(2, "0");
+            },
+            // 12小时制（h/hh）
+            "(h+)": (match) => {
+                const hour = date.getHours() % 12 || 12;
+                return match.length === 1 ? hour.toString() : hour.toString().padStart(2, "0");
+            },
+            // 24小时制（H/HH）
+            "(H+)": (match) => {
+                const hour = date.getHours();
+                return match.length === 1 ? hour.toString() : hour.toString().padStart(2, "0");
+            },
+            // 分钟（m/mm）
+            "(m+)": (match) => {
+                const min = date.getMinutes();
+                return match.length === 1 ? min.toString() : min.toString().padStart(2, "0");
+            },
+            // 秒（s/ss）
+            "(s+)": (match) => {
+                const sec = date.getSeconds();
+                return match.length === 1 ? sec.toString() : sec.toString().padStart(2, "0");
+            },
+            // 毫秒（S/SS/SSS）
+            "(S+)": (match) => {
+                const ms = date.getMilliseconds();
+                return ms.toString().padStart(match.length, "0").slice(0, match.length);
+            },
+            // 上午/下午（a/A/aa/AA）
+            "([aA]+)": (match) => {
+                const isAm = date.getHours() < 12;
+                // 多语言处理
+                if (match.length > 1) {
+                    return isAm ? DATE.AM_PM[lang].AM : DATE.AM_PM[lang].PM;
+                }
+                else {
+                    return isAm ? match.toLowerCase() : match.toUpperCase();
+                }
+            },
+            // 周（E/EE/EEE）
+            "(E+)": (match) => {
+                const day = date.getDay();
+                if (match.length === 1)
+                    return DATE.WEEK[lang].MINI[day];
+                if (match.length === 2)
+                    return DATE.WEEK[lang].SHORT[day];
+                return DATE.WEEK[lang].FULL[day];
+            },
+            // 季度（Q/QQ/QQQ）
+            "(Q+)": (match) => {
+                const quarter = Math.floor((date.getMonth() + 3) / 3) - 1;
+                if (match.length === 1)
+                    return DATE.QUARTER[lang].MINI[quarter];
+                if (match.length === 2)
+                    return DATE.QUARTER[lang].SHORT[quarter];
+                return DATE.QUARTER[lang].FULL[quarter];
+            },
+        };
+        // 批量替换格式
+        let result = format;
+        Object.entries(replaceRules).forEach(([regStr, replaceFn]) => {
+            const reg = new RegExp(regStr, "g");
+            result = result.replace(reg, (_, match) => replaceFn(match));
+        });
+        return result;
     }
-    // 不支持的日期格式
-    else {
-        console.error("Not supported date format!");
-        return value;
+    catch (e) {
+        console.error("Date to String error", e);
+        return "";
     }
 }
 /* 内部使用的函数 */
 /**
  * 单个数字前自动补齐零为两位
- * @param {String|Number} value 可以是数字和字符串
- * @returns {String} 返回处理后的字符串
+ * @param {string|number} value 可以是数字和字符串
+ * @returns {string} 返回处理后的字符串
  */
 function _digit(value) {
     value = value.toString();
     return value[1] ? value : "0" + value;
 }
 
-export { addDate, addHours, addMillisecond, addMinutes, addMonth, addQuarter, addSeconds, addWeek, addYear, formatDate, getAge, getBetweenDates, getBetweenMonths, getBetweenYears, getChineseZodiac, getDate, getDateArray, getDateObject, getDateTime, getDayOfMonth, getDayOfWeek, getDayOfYear, getDaysOfMonth, getDaysOfWeek, getDaysOfYear, getDiffDay, getDiffMonth, getDiffWeek, getDiffYear, getFirstDateOfMonth, getFirstDateOfWeek, getFirstDateOfYear, getFullDateOfMonth, getFullDateOfWeek, getFullDateOfYear, getLastDateOfMonth, getLastDateOfWeek, getLastDateOfYear, getNow, getOverTime, getPastTime, getQuarter, getTimestamp, getUnixTimestamp, getWeek, getWeekOfMonth, getWeekOfYear, getWeeksOfMonth, getWeeksOfYear, getZodiac, isAM, isAfter, isAfterTomorrow, isBefore, isBeforeYesterday, isBetween, isCommonYear, isFirstDayOfMonth, isFirstDayOfWeek, isFirstDayOfYear, isLastDayOfMonth, isLastDayOfWeek, isLastDayOfYear, isLeapYear, isPM, isSame, isSameMonth, isSameOrAfter, isSameOrBefore, isSameWeek, isSameYear, isToday, isTomorrow, isWeekend, isWorkday, isYesterday, lastMonth, lastWeek, lastYear, nextMonth, nextWeek, nextYear, parseDate, today, tomorrow, yesterday };
+export { addDate, addHours, addMillisecond, addMinutes, addMonth, addQuarter, addSeconds, addWeek, addYear, fromDateUTC, getAge, getBetweenDates, getBetweenMonths, getBetweenYears, getChineseZodiac, getDate, getDateArray, getDateObject, getDateTime, getDayOfMonth, getDayOfWeek, getDayOfYear, getDaysOfMonth, getDaysOfWeek, getDaysOfYear, getDiffDay, getDiffMonth, getDiffWeek, getDiffYear, getFirstDateOfMonth, getFirstDateOfWeek, getFirstDateOfYear, getFullDateOfMonth, getFullDateOfWeek, getFullDateOfYear, getLastDateOfMonth, getLastDateOfWeek, getLastDateOfYear, getNow, getOverTime, getPastTime, getQuarter, getTimestamp, getUnixTimestamp, getWeek, getWeekOfMonth, getWeekOfYear, getWeeksOfMonth, getWeeksOfYear, getZodiac, isAM, isAfter, isAfterTomorrow, isBefore, isBeforeYesterday, isBetween, isCommonYear, isFirstDayOfMonth, isFirstDayOfWeek, isFirstDayOfYear, isLastDayOfMonth, isLastDayOfWeek, isLastDayOfYear, isLeapYear, isPM, isSame, isSameMonth, isSameOrAfter, isSameOrBefore, isSameWeek, isSameYear, isToday, isTomorrow, isWeekend, isWorkday, isYesterday, lastMonth, lastWeek, lastYear, nextMonth, nextWeek, nextYear, toDataUTCString, toDate, toDateString, toDateUTC, today, tomorrow, yesterday };