@cloudcome/utils-core 1.16.0 → 1.17.0

package/dist/core.cjs

@@ -1,7 +1,7 @@
 "use strict";
 const type = require("./type.cjs");
-const TZ_OFFSET_MS = 60 * 1e3;
-class TzDate {
+const TIMEZONE_OFFSET_MS = 60 * 1e3;
+class TimezoneDate {
   /**
    * 内部时间戳
    */
@@ -17,35 +17,35 @@ class TzDate {
   /**
    * 本地时区偏移量（分钟）
    */
-  #localTZOffset = TzDate.getOffset();
+  #localTimezoneOffset = TimezoneDate.getTimezoneOffset();
   /**
    * 本地时区偏移量（毫秒）
    */
-  #localTzOffsetMS = this.#localTZOffset * TZ_OFFSET_MS;
+  #localTimezoneOffsetMS = this.#localTimezoneOffset * TIMEZONE_OFFSET_MS;
   /**
    * 目标时区偏移量（分钟）
    */
-  #targetTzOffset = 0;
+  #targetTimezoneOffset = 0;
   /**
    * 目标时区偏移量（毫秒）
    */
-  #targetTzOffsetMS = 0;
+  #targetTimezoneOffsetMS = 0;
   /**
    * 构造函数选项
    */
   #options;
   /**
-   * 构造一个 TzDate 实例
+   * 构造一个 TimezoneDate 实例
    * @param options - 配置选项
    */
   constructor(options) {
-    this.#options = (options instanceof TzDate ? {
+    this.#options = (options instanceof TimezoneDate ? {
       timestamp: options.getTime(),
-      offset: options.getTimezoneOffset()
+      utcOffset: options.getUTCOffset()
     } : options) || {};
-    const { offset, timestamp, value } = this.#options;
-    this.#targetTzOffset = type.isNumber(offset) ? offset : this.#localTZOffset;
-    this.#targetTzOffsetMS = this.#targetTzOffset * TZ_OFFSET_MS;
+    const { utcOffset, timestamp, value } = this.#options;
+    this.#targetTimezoneOffset = type.isNumber(utcOffset) ? TimezoneDate.getTimezoneOffset(utcOffset) : this.#localTimezoneOffset;
+    this.#targetTimezoneOffsetMS = this.#targetTimezoneOffset * TIMEZONE_OFFSET_MS;
     if (Array.isArray(value) && value.length > 0) {
       const [fullYear, month, day, hours, minutes, seconds, milliseconds] = value;
       const timestamp2 = Date.UTC(
@@ -57,33 +57,33 @@ class TzDate {
         seconds ?? 0,
         milliseconds ?? 0
       );
-      this.#timestamp = timestamp2 + this.#targetTzOffsetMS;
+      this.#timestamp = timestamp2 + this.#targetTimezoneOffsetMS;
     } else {
       this.#timestamp = timestamp || Date.now();
     }
-    this.#targetDate = new Date(this.#timestamp + this.#localTzOffsetMS - this.#targetTzOffsetMS);
-    this.#utcDate = new Date(this.#timestamp + this.#localTzOffsetMS);
+    this.#targetDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS - this.#targetTimezoneOffsetMS);
+    this.#utcDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS);
   }
   /**
    * 更新内部时间戳
    */
   #updateTimestamp() {
-    this.#timestamp = this.#targetDate.getTime() + this.#targetTzOffsetMS - this.#localTzOffsetMS;
-    this.#utcDate = new Date(this.#timestamp + this.#localTzOffsetMS);
+    this.#timestamp = this.#targetDate.getTime() + this.#targetTimezoneOffsetMS - this.#localTimezoneOffsetMS;
+    this.#utcDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS);
   }
   /**
    * 获取时区偏移量（分钟）
    * @returns 时区偏移量
    */
   getTimezoneOffset() {
-    return this.#targetTzOffset;
+    return this.#targetTimezoneOffset;
   }
   /**
-   * 获取时区序号
+   * 获取时区偏移量（UTC）
    * @returns 时区序号
    */
-  getTimezoneOrder() {
-    return TzDate.getOrder(this.#targetTzOffset);
+  getUTCOffset() {
+    return TimezoneDate.getUTCOffset(this.#targetTimezoneOffset);
   }
   /**
    * 获取年份
@@ -244,40 +244,44 @@ class TzDate {
     return dateFormat(this.#utcDate, "YYYY-MM-DDTHH:mm:ss.SSSZ");
   }
   /**
-   * 创建一个 TzDate 对象
+   * 转换为指定时区的 TimezoneDate 对象
    * @param td - 需要转换的日期对象
    * @param offset - 目标时区分钟偏移量，默认为当前时区
-   * @returns 返回一个 TzDate 对象
+   * @returns 返回一个 TimezoneDate 对象
    * @example
    * ```js
-   * const tzDate = TzDate.from(new TzDate());
+   * // 转换为 UTC 时间
+   * const utc0Td = TimezoneDate.changeUtcOffset(new TimezoneDate(), 0);
+   *
+   * // 转换为东八区时间
+   * const utc8Td = TimezoneDate.changeUtcOffset(new TimezoneDate(), 8);
    * ```
    */
-  static from(td, offset = TzDate.getOffset()) {
-    return new TzDate({
-      offset,
+  static changeUtcOffset(td, utcOffset) {
+    return new TimezoneDate({
+      utcOffset,
       timestamp: td.getTime()
     });
   }
   /**
-   * 获取时区序号
-   * @param offset - 默认使用当前时区分钟偏移量
-   * @returns 时区序号
+   * 获取时区分钟偏移量
+   * @param utcOffset - 默认使用当前时区
+   * @returns 时区分钟偏移量
    */
-  static getOrder(offset = TzDate.getOffset()) {
-    return offset / -60;
+  static getTimezoneOffset(utcOffset) {
+    return type.isNumber(utcOffset) ? utcOffset * -60 : (/* @__PURE__ */ new Date()).getTimezoneOffset();
   }
   /**
-   * 获取时区分钟偏移量
-   * @param gmtOrder - 默认使用当前时区序号
-   * @returns 时区分钟偏移量
+   * 获取时区序号
+   * @param timezoneOffset - 默认使用当前时区分钟偏移量
+   * @returns 时区序号
    */
-  static getOffset(gmtOrder) {
-    return type.isNumber(gmtOrder) ? gmtOrder * -60 : (/* @__PURE__ */ new Date()).getTimezoneOffset();
+  static getUTCOffset(timezoneOffset = TimezoneDate.getTimezoneOffset()) {
+    return timezoneOffset / -60;
   }
 }
 function isValidDate(unknown) {
-  return unknown instanceof Date && !Number.isNaN(unknown.getTime()) || unknown instanceof TzDate && !Number.isNaN(unknown.getTime());
+  return unknown instanceof Date && !Number.isNaN(unknown.getTime()) || unknown instanceof TimezoneDate && !Number.isNaN(unknown.getTime());
 }
 function _guessDateSeparator(value) {
   if (!type.isString(value)) return;
@@ -301,7 +305,7 @@ function _guessDateTimezone(value) {
   return d;
 }
 function dateParse(dateValue) {
-  const d1 = type.isDate(dateValue) ? new Date(dateValue) : dateValue instanceof TzDate ? new TzDate(dateValue) : new Date(dateValue);
+  const d1 = type.isDate(dateValue) ? new Date(dateValue) : dateValue instanceof TimezoneDate ? new TimezoneDate(dateValue) : new Date(dateValue);
   if (isValidDate(d1)) return d1;
   const d2 = _guessDateSeparator(dateValue);
   if (isValidDate(d2)) return d2;
@@ -351,7 +355,7 @@ function dateFormat(dateValue, format = "YYYY-MM-DD HH:mm:ss") {
   }
   return result;
 }
-exports.TzDate = TzDate;
+exports.TimezoneDate = TimezoneDate;
 exports.dateFormat = dateFormat;
 exports.dateParse = dateParse;
 exports.isValidDate = isValidDate;

package/dist/core.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"core.cjs","sources":["../src/date/timezone.ts","../src/date/core.ts"],"sourcesContent":["import { isNumber } from '../type';\nimport { dateFormat } from './core';\n\nexport type TzDateOptions = {\n  /**\n   * 时间戳\n   * @default Date.now()\n   */\n  timestamp?: number;\n\n  /**\n   * 日期值\n   */\n  value?: readonly [\n    year?: number,\n    month?: number,\n    day?: number,\n    hours?: number,\n    minutes?: number,\n    seconds?: number,\n    milliseconds?: number,\n  ];\n\n  /**\n   * 时区偏移量，单位为分钟，默认为当前时区\n   */\n  offset?: number;\n};\n\n/**\n * 时区偏移量毫秒常量（1分钟 = 60 * 1000 毫秒）\n */\nconst TZ_OFFSET_MS = 60 * 1000;\n\n/**\n * 时区日期类，用于处理不同时区的日期时间\n */\nexport class TzDate {\n  /**\n   * 内部时间戳\n   */\n  #timestamp: number;\n\n  /**\n   * 目标时区的日期对象\n   */\n  #targetDate: Date;\n\n  /**\n   * UTC 日期对象\n   */\n  #utcDate: Date;\n\n  /**\n   * 本地时区偏移量（分钟）\n   */\n  #localTZOffset = TzDate.getOffset();\n\n  /**\n   * 本地时区偏移量（毫秒）\n   */\n  #localTzOffsetMS = this.#localTZOffset * TZ_OFFSET_MS;\n\n  /**\n   * 目标时区偏移量（分钟）\n   */\n  #targetTzOffset = 0;\n\n  /**\n   * 目标时区偏移量（毫秒）\n   */\n  #targetTzOffsetMS = 0;\n\n  /**\n   * 构造函数选项\n   */\n  #options: TzDateOptions;\n\n  /**\n   * 构造一个 TzDate 实例\n   * @param options - 配置选项\n   */\n  constructor(options?: TzDateOptions | TzDate) {\n    this.#options =\n      (options instanceof TzDate\n        ? {\n            timestamp: options.getTime(),\n            offset: options.getTimezoneOffset(),\n          }\n        : options) || {};\n    const { offset, timestamp, value } = this.#options;\n    this.#targetTzOffset = isNumber(offset) ? offset : this.#localTZOffset;\n    this.#targetTzOffsetMS = this.#targetTzOffset * TZ_OFFSET_MS;\n\n    if (Array.isArray(value) && value.length > 0) {\n      const [fullYear, month, day, hours, minutes, seconds, milliseconds] = value;\n      const timestamp = Date.UTC(\n        fullYear ?? 0,\n        month ?? 0,\n        day ?? 1,\n        hours ?? 0,\n        minutes ?? 0,\n        seconds ?? 0,\n        milliseconds ?? 0,\n      );\n\n      this.#timestamp = timestamp + this.#targetTzOffsetMS;\n    } else {\n      this.#timestamp = timestamp || Date.now();\n    }\n\n    this.#targetDate = new Date(this.#timestamp + this.#localTzOffsetMS - this.#targetTzOffsetMS);\n    this.#utcDate = new Date(this.#timestamp + this.#localTzOffsetMS);\n  }\n\n  /**\n   * 更新内部时间戳\n   */\n  #updateTimestamp() {\n    this.#timestamp = this.#targetDate.getTime() + this.#targetTzOffsetMS - this.#localTzOffsetMS;\n    this.#utcDate = new Date(this.#timestamp + this.#localTzOffsetMS);\n  }\n\n  /**\n   * 获取时区偏移量（分钟）\n   * @returns 时区偏移量\n   */\n  getTimezoneOffset() {\n    return this.#targetTzOffset;\n  }\n\n  /**\n   * 获取时区序号\n   * @returns 时区序号\n   */\n  getTimezoneOrder() {\n    return TzDate.getOrder(this.#targetTzOffset);\n  }\n\n  /**\n   * 获取年份\n   * @returns 年份\n   */\n  getFullYear() {\n    return this.#targetDate.getFullYear();\n  }\n\n  /**\n   * 获取月份\n   * @returns 月份 (0-11)\n   */\n  getMonth() {\n    return this.#targetDate.getMonth();\n  }\n\n  /**\n   * 获取日期\n   * @returns 日期 (1-31)\n   */\n  getDate() {\n    return this.#targetDate.getDate();\n  }\n\n  /**\n   * 获取小时\n   * @returns 小时 (0-23)\n   */\n  getHours() {\n    return this.#targetDate.getHours();\n  }\n\n  /**\n   * 获取分钟\n   * @returns 分钟 (0-59)\n   */\n  getMinutes() {\n    return this.#targetDate.getMinutes();\n  }\n\n  /**\n   * 获取秒数\n   * @returns 秒数 (0-59)\n   */\n  getSeconds() {\n    return this.#targetDate.getSeconds();\n  }\n\n  /**\n   * 获取毫秒\n   * @returns 毫秒 (0-999)\n   */\n  getMilliseconds() {\n    return this.#targetDate.getMilliseconds();\n  }\n\n  /**\n   * 设置年份\n   * @param year - 年份\n   * @param month - 月份\n   * @param date - 日期\n   * @returns 时间戳\n   */\n  setFullYear(year: number, month?: number, date?: number) {\n    this.#targetDate.setFullYear(year);\n    this.#updateTimestamp();\n\n    if (isNumber(month)) this.setMonth(month);\n    if (isNumber(date)) this.setDate(date);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置月份\n   * @param month - 月份\n   * @param date - 日期\n   * @returns 时间戳\n   */\n  setMonth(month: number, date?: number) {\n    this.#targetDate.setMonth(month);\n    this.#updateTimestamp();\n\n    if (isNumber(date)) this.setDate(date);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置日期\n   * @param date - 日期\n   * @returns 时间戳\n   */\n  setDate(date: number) {\n    this.#targetDate.setDate(date);\n    this.#updateTimestamp();\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置小时\n   * @param hours - 小时\n   * @param minutes - 分钟\n   * @param seconds - 秒数\n   * @param milliseconds - 毫秒\n   * @returns 时间戳\n   */\n  setHours(hours: number, minutes?: number, seconds?: number, milliseconds?: number) {\n    this.#targetDate.setHours(hours);\n    this.#updateTimestamp();\n\n    if (isNumber(minutes)) this.setMinutes(minutes);\n    if (isNumber(seconds)) this.setSeconds(seconds);\n    if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置分钟\n   * @param minutes - 分钟\n   * @param seconds - 秒数\n   * @param milliseconds - 毫秒\n   * @returns 时间戳\n   */\n  setMinutes(minutes: number, seconds?: number, milliseconds?: number) {\n    this.#targetDate.setMinutes(minutes);\n    this.#updateTimestamp();\n\n    if (isNumber(seconds)) this.setSeconds(seconds);\n    if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置秒数\n   * @param seconds - 秒数\n   * @param milliseconds - 毫秒\n   * @returns 时间戳\n   */\n  setSeconds(seconds: number, milliseconds?: number) {\n    this.#targetDate.setSeconds(seconds);\n    this.#updateTimestamp();\n\n    if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置毫秒\n   * @param milliseconds - 毫秒\n   * @returns 时间戳\n   */\n  setMilliseconds(milliseconds: number) {\n    this.#targetDate.setMilliseconds(milliseconds);\n    this.#updateTimestamp();\n\n    return this.getTime();\n  }\n\n  /**\n   * 获取时间戳\n   * @returns 时间戳\n   */\n  getTime() {\n    return this.#timestamp;\n  }\n\n  /**\n   * 获取星期几\n   * @returns 星期几 (0-6, 0表示周日)\n   */\n  getDay() {\n    return this.#targetDate.getDay();\n  }\n\n  /**\n   * 转换为 ISO 格式的字符串\n   * @returns ISO 格式的时间字符串\n   */\n  toISOString() {\n    return dateFormat(this.#utcDate, 'YYYY-MM-DDTHH:mm:ss.SSSZ');\n  }\n\n  /**\n   * 创建一个 TzDate 对象\n   * @param td - 需要转换的日期对象\n   * @param offset - 目标时区分钟偏移量，默认为当前时区\n   * @returns 返回一个 TzDate 对象\n   * @example\n   * ```js\n   * const tzDate = TzDate.from(new TzDate());\n   * ```\n   */\n  static from(td: TzDate, offset = TzDate.getOffset()) {\n    return new TzDate({\n      offset: offset,\n      timestamp: td.getTime(),\n    });\n  }\n\n  /**\n   * 获取时区序号\n   * @param offset - 默认使用当前时区分钟偏移量\n   * @returns 时区序号\n   */\n  static getOrder(offset = TzDate.getOffset()) {\n    return offset / -60;\n  }\n\n  /**\n   * 获取时区分钟偏移量\n   * @param gmtOrder - 默认使用当前时区序号\n   * @returns 时区分钟偏移量\n   */\n  static getOffset(gmtOrder?: number) {\n    return isNumber(gmtOrder) ? gmtOrder * -60 : new Date().getTimezoneOffset();\n  }\n}\n","import { objectEach } from '@/object';\nimport { isDate, isString } from '@/type';\nimport { TzDate } from './timezone';\n\n/**\n * 判断一个值是否为有效的日期对象\n * @param unknown - 需要判断的值\n * @returns 如果值是有效的日期对象则返回 true，否则返回 false\n * @example\n * ```typescript\n * isValidDate(new Date()); // true\n * isValidDate('2023-01-01'); // false\n * isValidDate(NaN); // false\n * ```\n */\nexport function isValidDate(unknown: unknown): unknown is Date | TzDate {\n  return (\n    (unknown instanceof Date && !Number.isNaN(unknown.getTime())) ||\n    (unknown instanceof TzDate && !Number.isNaN(unknown.getTime()))\n  );\n}\n\nexport type DateLike = Date | TzDate;\nexport type DateValue = number | string | DateLike;\n\nfunction _guessDateSeparator(value: DateValue): Date | undefined {\n  if (!isString(value)) return;\n\n  const value2 = value.replace(/-/g, '/');\n\n  return new Date(value2);\n}\n\nfunction _guessDateTimezone(value: DateValue): Date | undefined {\n  if (!isString(value)) return;\n\n  const re = /([+-])(\\d\\d)(\\d\\d)$/;\n\n  const matches = re.exec(value);\n\n  if (!matches) return;\n\n  const value2 = value.replace(re, 'Z');\n  const d = new Date(value2);\n\n  if (!isValidDate(d)) return;\n\n  const [, flag, hours, minutes] = matches;\n  const hours2 = Number.parseInt(hours, 10);\n  const minutes2 = Number.parseInt(minutes, 10);\n  const offset = (a: number, b: number): number => (flag === '+' ? a - b : a + b);\n\n  d.setHours(offset(d.getHours(), hours2));\n  d.setMinutes(offset(d.getMinutes(), minutes2));\n\n  return d;\n}\n\n/**\n * 解析为Date对象\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 解析后的 Date 对象\n * @throws {SyntaxError} 如果无法解析为有效的日期对象，则抛出错误\n * @example\n * ```typescript\n * dateParse('2023-01-01'); // Date对象\n * dateParse(1672531200000); // Date对象\n * dateParse(new Date()); // Date对象\n * dateParse('invalid date'); // 抛出 SyntaxError\n * ```\n */\nexport function dateParse(dateValue: DateValue): DateLike {\n  // 传入的 Date 对象有 Date、TzDate\n  // @ts-ignore\n  const d1 = isDate(dateValue)\n    ? new Date(dateValue)\n    : dateValue instanceof TzDate\n      ? new TzDate(dateValue)\n      : new Date(dateValue);\n  if (isValidDate(d1)) return d1;\n\n  // safari 浏览器的日期解析有问题\n  // new Date('2020-06-26 18:06:15') 返回值是一个非法日期对象\n  const d2 = _guessDateSeparator(dateValue);\n  if (isValidDate(d2)) return d2;\n\n  // safari 浏览器的日期解析有问题\n  // new Date('2020-06-26T18:06:15.000+0800') 返回值是一个非法日期对象\n  const d3 = _guessDateTimezone(dateValue);\n  if (isValidDate(d3)) return d3;\n\n  throw new SyntaxError(`${dateValue.toString()} 不是一个合法的日期值`);\n}\n\nfunction _pad(num: number, len = 2) {\n  return `${num}`.padStart(len, '0');\n}\n\nconst rules: [RegExp, (date: DateLike) => number | string][] = [\n  [/Y{4}/gi, (date) => date.getFullYear()],\n  [/Y{2}/gi, (date) => date.getFullYear() % 100],\n  [/M{2}/g, (date) => _pad(date.getMonth() + 1)],\n  [/M{1}/g, (date) => date.getMonth() + 1],\n  [/D{2}/gi, (date) => _pad(date.getDate())],\n  [/D{1}/gi, (date) => date.getDate()],\n  [/H{2}/g, (date) => _pad(date.getHours())],\n  [/H{1}/g, (date) => date.getHours()],\n  [\n    /h{2}/g,\n    (date) => {\n      const h = date.getHours();\n      return _pad(h > 12 ? h - 12 : h);\n    },\n  ],\n  [\n    /h{1}/g,\n    (date) => {\n      const h = date.getHours();\n      return h > 12 ? h - 12 : h;\n    },\n  ],\n  [/m{2}/g, (date) => _pad(date.getMinutes())],\n  [/m{1}/g, (date) => date.getMinutes()],\n  [/s{2}/g, (date) => _pad(date.getSeconds())],\n  [/s{1}/g, (date) => date.getSeconds()],\n  [/S{3}/g, (date) => _pad(date.getMilliseconds(), 3)],\n  [/S{2}/g, (date) => _pad(date.getMilliseconds(), 2)],\n  [/S{1}/g, (date) => date.getMilliseconds()],\n];\n\n/**\n * 格式化为日期字符串(带自定义格式化模板)\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param format - 模板，默认是 'YYYY-MM-DD HH:mm:ss'，模板字符：\n * - YYYY：年\n * - yyyy: 年\n * - MM：月\n * - DD：日\n * - dd: 日\n * - HH：时（24 小时制）\n * - hh：时（12 小时制）\n * - mm：分\n * - ss：秒\n * - SSS：毫秒\n * @returns 格式化后的日期字符串\n * @example\n * ```typescript\n * dateFormat(new Date(), 'YYYY-MM-DD'); // '2023-01-01'\n * dateFormat(1672531200000, 'YYYY/MM/DD HH:mm:ss'); // '2023/01/01 00:00:00'\n * dateFormat('2023-01-01', 'YYYY年MM月DD日'); // '2023年01月01日'\n * ```\n */\nexport function dateFormat(dateValue: DateValue, format = 'YYYY-MM-DD HH:mm:ss'): string {\n  const date = dateParse(dateValue);\n  let result = format;\n\n  for (const rule of rules) {\n    result = result.replace(rule[0], String(rule[1](date)));\n  }\n\n  return result;\n}\n"],"names":["isNumber","timestamp","isString","isDate"],"mappings":"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"}
+{"version":3,"file":"core.cjs","sources":["../src/date/timezone.ts","../src/date/core.ts"],"sourcesContent":["import { isNumber } from '../type';\nimport { dateFormat } from './core';\n\nexport type TimezoneDateOptions = {\n  /**\n   * 时间戳\n   * @default Date.now()\n   */\n  timestamp?: number;\n\n  /**\n   * 日期值\n   */\n  value?: readonly [\n    year?: number,\n    month?: number,\n    day?: number,\n    hours?: number,\n    minutes?: number,\n    seconds?: number,\n    milliseconds?: number,\n  ];\n\n  /**\n   * UTC 时区，支持负数和小数，例如：\n   * - 8 表示 UTC+8\n   * - -12 表示 UTC-12\n   * - 0 表示 UTC 时间\n   * - 12.5 表示 UTC+12:30\n   */\n  utcOffset?: number;\n};\n\n/**\n * 时区偏移量毫秒常量（1分钟 = 60 * 1000 毫秒）\n */\nconst TIMEZONE_OFFSET_MS = 60 * 1000;\n\n/**\n * 时区日期类，用于处理不同时区的日期时间\n */\nexport class TimezoneDate {\n  /**\n   * 内部时间戳\n   */\n  #timestamp: number;\n\n  /**\n   * 目标时区的日期对象\n   */\n  #targetDate: Date;\n\n  /**\n   * UTC 日期对象\n   */\n  #utcDate: Date;\n\n  /**\n   * 本地时区偏移量（分钟）\n   */\n  #localTimezoneOffset = TimezoneDate.getTimezoneOffset();\n\n  /**\n   * 本地时区偏移量（毫秒）\n   */\n  #localTimezoneOffsetMS = this.#localTimezoneOffset * TIMEZONE_OFFSET_MS;\n\n  /**\n   * 目标时区偏移量（分钟）\n   */\n  #targetTimezoneOffset = 0;\n\n  /**\n   * 目标时区偏移量（毫秒）\n   */\n  #targetTimezoneOffsetMS = 0;\n\n  /**\n   * 构造函数选项\n   */\n  #options: TimezoneDateOptions;\n\n  /**\n   * 构造一个 TimezoneDate 实例\n   * @param options - 配置选项\n   */\n  constructor(options?: TimezoneDateOptions | TimezoneDate) {\n    this.#options =\n      (options instanceof TimezoneDate\n        ? {\n            timestamp: options.getTime(),\n            utcOffset: options.getUTCOffset(),\n          }\n        : options) || {};\n    const { utcOffset, timestamp, value } = this.#options;\n    this.#targetTimezoneOffset = isNumber(utcOffset)\n      ? TimezoneDate.getTimezoneOffset(utcOffset)\n      : this.#localTimezoneOffset;\n    this.#targetTimezoneOffsetMS = this.#targetTimezoneOffset * TIMEZONE_OFFSET_MS;\n\n    if (Array.isArray(value) && value.length > 0) {\n      const [fullYear, month, day, hours, minutes, seconds, milliseconds] = value;\n      const timestamp = Date.UTC(\n        fullYear ?? 0,\n        month ?? 0,\n        day ?? 1,\n        hours ?? 0,\n        minutes ?? 0,\n        seconds ?? 0,\n        milliseconds ?? 0,\n      );\n\n      this.#timestamp = timestamp + this.#targetTimezoneOffsetMS;\n    } else {\n      this.#timestamp = timestamp || Date.now();\n    }\n\n    this.#targetDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS - this.#targetTimezoneOffsetMS);\n    this.#utcDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS);\n  }\n\n  /**\n   * 更新内部时间戳\n   */\n  #updateTimestamp() {\n    this.#timestamp = this.#targetDate.getTime() + this.#targetTimezoneOffsetMS - this.#localTimezoneOffsetMS;\n    this.#utcDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS);\n  }\n\n  /**\n   * 获取时区偏移量（分钟）\n   * @returns 时区偏移量\n   */\n  getTimezoneOffset() {\n    return this.#targetTimezoneOffset;\n  }\n\n  /**\n   * 获取时区偏移量（UTC）\n   * @returns 时区序号\n   */\n  getUTCOffset() {\n    return TimezoneDate.getUTCOffset(this.#targetTimezoneOffset);\n  }\n\n  /**\n   * 获取年份\n   * @returns 年份\n   */\n  getFullYear() {\n    return this.#targetDate.getFullYear();\n  }\n\n  /**\n   * 获取月份\n   * @returns 月份 (0-11)\n   */\n  getMonth() {\n    return this.#targetDate.getMonth();\n  }\n\n  /**\n   * 获取日期\n   * @returns 日期 (1-31)\n   */\n  getDate() {\n    return this.#targetDate.getDate();\n  }\n\n  /**\n   * 获取小时\n   * @returns 小时 (0-23)\n   */\n  getHours() {\n    return this.#targetDate.getHours();\n  }\n\n  /**\n   * 获取分钟\n   * @returns 分钟 (0-59)\n   */\n  getMinutes() {\n    return this.#targetDate.getMinutes();\n  }\n\n  /**\n   * 获取秒数\n   * @returns 秒数 (0-59)\n   */\n  getSeconds() {\n    return this.#targetDate.getSeconds();\n  }\n\n  /**\n   * 获取毫秒\n   * @returns 毫秒 (0-999)\n   */\n  getMilliseconds() {\n    return this.#targetDate.getMilliseconds();\n  }\n\n  /**\n   * 设置年份\n   * @param year - 年份\n   * @param month - 月份\n   * @param date - 日期\n   * @returns 时间戳\n   */\n  setFullYear(year: number, month?: number, date?: number) {\n    this.#targetDate.setFullYear(year);\n    this.#updateTimestamp();\n\n    if (isNumber(month)) this.setMonth(month);\n    if (isNumber(date)) this.setDate(date);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置月份\n   * @param month - 月份\n   * @param date - 日期\n   * @returns 时间戳\n   */\n  setMonth(month: number, date?: number) {\n    this.#targetDate.setMonth(month);\n    this.#updateTimestamp();\n\n    if (isNumber(date)) this.setDate(date);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置日期\n   * @param date - 日期\n   * @returns 时间戳\n   */\n  setDate(date: number) {\n    this.#targetDate.setDate(date);\n    this.#updateTimestamp();\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置小时\n   * @param hours - 小时\n   * @param minutes - 分钟\n   * @param seconds - 秒数\n   * @param milliseconds - 毫秒\n   * @returns 时间戳\n   */\n  setHours(hours: number, minutes?: number, seconds?: number, milliseconds?: number) {\n    this.#targetDate.setHours(hours);\n    this.#updateTimestamp();\n\n    if (isNumber(minutes)) this.setMinutes(minutes);\n    if (isNumber(seconds)) this.setSeconds(seconds);\n    if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置分钟\n   * @param minutes - 分钟\n   * @param seconds - 秒数\n   * @param milliseconds - 毫秒\n   * @returns 时间戳\n   */\n  setMinutes(minutes: number, seconds?: number, milliseconds?: number) {\n    this.#targetDate.setMinutes(minutes);\n    this.#updateTimestamp();\n\n    if (isNumber(seconds)) this.setSeconds(seconds);\n    if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置秒数\n   * @param seconds - 秒数\n   * @param milliseconds - 毫秒\n   * @returns 时间戳\n   */\n  setSeconds(seconds: number, milliseconds?: number) {\n    this.#targetDate.setSeconds(seconds);\n    this.#updateTimestamp();\n\n    if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置毫秒\n   * @param milliseconds - 毫秒\n   * @returns 时间戳\n   */\n  setMilliseconds(milliseconds: number) {\n    this.#targetDate.setMilliseconds(milliseconds);\n    this.#updateTimestamp();\n\n    return this.getTime();\n  }\n\n  /**\n   * 获取时间戳\n   * @returns 时间戳\n   */\n  getTime() {\n    return this.#timestamp;\n  }\n\n  /**\n   * 获取星期几\n   * @returns 星期几 (0-6, 0表示周日)\n   */\n  getDay() {\n    return this.#targetDate.getDay();\n  }\n\n  /**\n   * 转换为 ISO 格式的字符串\n   * @returns ISO 格式的时间字符串\n   */\n  toISOString() {\n    return dateFormat(this.#utcDate, 'YYYY-MM-DDTHH:mm:ss.SSSZ');\n  }\n\n  /**\n   * 转换为指定时区的 TimezoneDate 对象\n   * @param td - 需要转换的日期对象\n   * @param offset - 目标时区分钟偏移量，默认为当前时区\n   * @returns 返回一个 TimezoneDate 对象\n   * @example\n   * ```js\n   * // 转换为 UTC 时间\n   * const utc0Td = TimezoneDate.changeUtcOffset(new TimezoneDate(), 0);\n   *\n   * // 转换为东八区时间\n   * const utc8Td = TimezoneDate.changeUtcOffset(new TimezoneDate(), 8);\n   * ```\n   */\n  static changeUtcOffset(td: TimezoneDate, utcOffset: number) {\n    return new TimezoneDate({\n      utcOffset,\n      timestamp: td.getTime(),\n    });\n  }\n\n  /**\n   * 获取时区分钟偏移量\n   * @param utcOffset - 默认使用当前时区\n   * @returns 时区分钟偏移量\n   */\n  static getTimezoneOffset(utcOffset?: number) {\n    return isNumber(utcOffset) ? utcOffset * -60 : new Date().getTimezoneOffset();\n  }\n\n  /**\n   * 获取时区序号\n   * @param timezoneOffset - 默认使用当前时区分钟偏移量\n   * @returns 时区序号\n   */\n  static getUTCOffset(timezoneOffset = TimezoneDate.getTimezoneOffset()) {\n    return timezoneOffset / -60;\n  }\n}\n","import { objectEach } from '@/object';\nimport { isDate, isString } from '@/type';\nimport { TimezoneDate } from './timezone';\n\n/**\n * 判断一个值是否为有效的日期对象\n * @param unknown - 需要判断的值\n * @returns 如果值是有效的日期对象则返回 true，否则返回 false\n * @example\n * ```typescript\n * isValidDate(new Date()); // true\n * isValidDate('2023-01-01'); // false\n * isValidDate(NaN); // false\n * ```\n */\nexport function isValidDate(unknown: unknown): unknown is Date | TimezoneDate {\n  return (\n    (unknown instanceof Date && !Number.isNaN(unknown.getTime())) ||\n    (unknown instanceof TimezoneDate && !Number.isNaN(unknown.getTime()))\n  );\n}\n\nexport type DateLike = Date | TimezoneDate;\nexport type DateValue = number | string | DateLike;\n\nfunction _guessDateSeparator(value: DateValue): Date | undefined {\n  if (!isString(value)) return;\n\n  const value2 = value.replace(/-/g, '/');\n\n  return new Date(value2);\n}\n\nfunction _guessDateTimezone(value: DateValue): Date | undefined {\n  if (!isString(value)) return;\n\n  const re = /([+-])(\\d\\d)(\\d\\d)$/;\n\n  const matches = re.exec(value);\n\n  if (!matches) return;\n\n  const value2 = value.replace(re, 'Z');\n  const d = new Date(value2);\n\n  if (!isValidDate(d)) return;\n\n  const [, flag, hours, minutes] = matches;\n  const hours2 = Number.parseInt(hours, 10);\n  const minutes2 = Number.parseInt(minutes, 10);\n  const offset = (a: number, b: number): number => (flag === '+' ? a - b : a + b);\n\n  d.setHours(offset(d.getHours(), hours2));\n  d.setMinutes(offset(d.getMinutes(), minutes2));\n\n  return d;\n}\n\n/**\n * 解析为Date对象\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 解析后的 Date 对象\n * @throws {SyntaxError} 如果无法解析为有效的日期对象，则抛出错误\n * @example\n * ```typescript\n * dateParse('2023-01-01'); // Date对象\n * dateParse(1672531200000); // Date对象\n * dateParse(new Date()); // Date对象\n * dateParse('invalid date'); // 抛出 SyntaxError\n * ```\n */\nexport function dateParse(dateValue: DateValue): DateLike {\n  // 传入的 Date 对象有 Date、TimezoneDate\n  // @ts-ignore\n  const d1 = isDate(dateValue)\n    ? new Date(dateValue)\n    : dateValue instanceof TimezoneDate\n      ? new TimezoneDate(dateValue)\n      : new Date(dateValue);\n  if (isValidDate(d1)) return d1;\n\n  // safari 浏览器的日期解析有问题\n  // new Date('2020-06-26 18:06:15') 返回值是一个非法日期对象\n  const d2 = _guessDateSeparator(dateValue);\n  if (isValidDate(d2)) return d2;\n\n  // safari 浏览器的日期解析有问题\n  // new Date('2020-06-26T18:06:15.000+0800') 返回值是一个非法日期对象\n  const d3 = _guessDateTimezone(dateValue);\n  if (isValidDate(d3)) return d3;\n\n  throw new SyntaxError(`${dateValue.toString()} 不是一个合法的日期值`);\n}\n\nfunction _pad(num: number, len = 2) {\n  return `${num}`.padStart(len, '0');\n}\n\nconst rules: [RegExp, (date: DateLike) => number | string][] = [\n  [/Y{4}/gi, (date) => date.getFullYear()],\n  [/Y{2}/gi, (date) => date.getFullYear() % 100],\n  [/M{2}/g, (date) => _pad(date.getMonth() + 1)],\n  [/M{1}/g, (date) => date.getMonth() + 1],\n  [/D{2}/gi, (date) => _pad(date.getDate())],\n  [/D{1}/gi, (date) => date.getDate()],\n  [/H{2}/g, (date) => _pad(date.getHours())],\n  [/H{1}/g, (date) => date.getHours()],\n  [\n    /h{2}/g,\n    (date) => {\n      const h = date.getHours();\n      return _pad(h > 12 ? h - 12 : h);\n    },\n  ],\n  [\n    /h{1}/g,\n    (date) => {\n      const h = date.getHours();\n      return h > 12 ? h - 12 : h;\n    },\n  ],\n  [/m{2}/g, (date) => _pad(date.getMinutes())],\n  [/m{1}/g, (date) => date.getMinutes()],\n  [/s{2}/g, (date) => _pad(date.getSeconds())],\n  [/s{1}/g, (date) => date.getSeconds()],\n  [/S{3}/g, (date) => _pad(date.getMilliseconds(), 3)],\n  [/S{2}/g, (date) => _pad(date.getMilliseconds(), 2)],\n  [/S{1}/g, (date) => date.getMilliseconds()],\n];\n\n/**\n * 格式化为日期字符串(带自定义格式化模板)\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param format - 模板，默认是 'YYYY-MM-DD HH:mm:ss'，模板字符：\n * - YYYY：年\n * - yyyy: 年\n * - MM：月\n * - DD：日\n * - dd: 日\n * - HH：时（24 小时制）\n * - hh：时（12 小时制）\n * - mm：分\n * - ss：秒\n * - SSS：毫秒\n * @returns 格式化后的日期字符串\n * @example\n * ```typescript\n * dateFormat(new Date(), 'YYYY-MM-DD'); // '2023-01-01'\n * dateFormat(1672531200000, 'YYYY/MM/DD HH:mm:ss'); // '2023/01/01 00:00:00'\n * dateFormat('2023-01-01', 'YYYY年MM月DD日'); // '2023年01月01日'\n * ```\n */\nexport function dateFormat(dateValue: DateValue, format = 'YYYY-MM-DD HH:mm:ss'): string {\n  const date = dateParse(dateValue);\n  let result = format;\n\n  for (const rule of rules) {\n    result = result.replace(rule[0], String(rule[1](date)));\n  }\n\n  return result;\n}\n"],"names":["isNumber","timestamp","isString","isDate"],"mappings":"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"}

package/dist/core.mjs

@@ -1,6 +1,6 @@
 import { isNumber, isDate, isString } from "./type.mjs";
-const TZ_OFFSET_MS = 60 * 1e3;
-class TzDate {
+const TIMEZONE_OFFSET_MS = 60 * 1e3;
+class TimezoneDate {
   /**
    * 内部时间戳
    */
@@ -16,35 +16,35 @@ class TzDate {
   /**
    * 本地时区偏移量（分钟）
    */
-  #localTZOffset = TzDate.getOffset();
+  #localTimezoneOffset = TimezoneDate.getTimezoneOffset();
   /**
    * 本地时区偏移量（毫秒）
    */
-  #localTzOffsetMS = this.#localTZOffset * TZ_OFFSET_MS;
+  #localTimezoneOffsetMS = this.#localTimezoneOffset * TIMEZONE_OFFSET_MS;
   /**
    * 目标时区偏移量（分钟）
    */
-  #targetTzOffset = 0;
+  #targetTimezoneOffset = 0;
   /**
    * 目标时区偏移量（毫秒）
    */
-  #targetTzOffsetMS = 0;
+  #targetTimezoneOffsetMS = 0;
   /**
    * 构造函数选项
    */
   #options;
   /**
-   * 构造一个 TzDate 实例
+   * 构造一个 TimezoneDate 实例
    * @param options - 配置选项
    */
   constructor(options) {
-    this.#options = (options instanceof TzDate ? {
+    this.#options = (options instanceof TimezoneDate ? {
       timestamp: options.getTime(),
-      offset: options.getTimezoneOffset()
+      utcOffset: options.getUTCOffset()
     } : options) || {};
-    const { offset, timestamp, value } = this.#options;
-    this.#targetTzOffset = isNumber(offset) ? offset : this.#localTZOffset;
-    this.#targetTzOffsetMS = this.#targetTzOffset * TZ_OFFSET_MS;
+    const { utcOffset, timestamp, value } = this.#options;
+    this.#targetTimezoneOffset = isNumber(utcOffset) ? TimezoneDate.getTimezoneOffset(utcOffset) : this.#localTimezoneOffset;
+    this.#targetTimezoneOffsetMS = this.#targetTimezoneOffset * TIMEZONE_OFFSET_MS;
     if (Array.isArray(value) && value.length > 0) {
       const [fullYear, month, day, hours, minutes, seconds, milliseconds] = value;
       const timestamp2 = Date.UTC(
@@ -56,33 +56,33 @@ class TzDate {
         seconds ?? 0,
         milliseconds ?? 0
       );
-      this.#timestamp = timestamp2 + this.#targetTzOffsetMS;
+      this.#timestamp = timestamp2 + this.#targetTimezoneOffsetMS;
     } else {
       this.#timestamp = timestamp || Date.now();
     }
-    this.#targetDate = new Date(this.#timestamp + this.#localTzOffsetMS - this.#targetTzOffsetMS);
-    this.#utcDate = new Date(this.#timestamp + this.#localTzOffsetMS);
+    this.#targetDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS - this.#targetTimezoneOffsetMS);
+    this.#utcDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS);
   }
   /**
    * 更新内部时间戳
    */
   #updateTimestamp() {
-    this.#timestamp = this.#targetDate.getTime() + this.#targetTzOffsetMS - this.#localTzOffsetMS;
-    this.#utcDate = new Date(this.#timestamp + this.#localTzOffsetMS);
+    this.#timestamp = this.#targetDate.getTime() + this.#targetTimezoneOffsetMS - this.#localTimezoneOffsetMS;
+    this.#utcDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS);
   }
   /**
    * 获取时区偏移量（分钟）
    * @returns 时区偏移量
    */
   getTimezoneOffset() {
-    return this.#targetTzOffset;
+    return this.#targetTimezoneOffset;
   }
   /**
-   * 获取时区序号
+   * 获取时区偏移量（UTC）
    * @returns 时区序号
    */
-  getTimezoneOrder() {
-    return TzDate.getOrder(this.#targetTzOffset);
+  getUTCOffset() {
+    return TimezoneDate.getUTCOffset(this.#targetTimezoneOffset);
   }
   /**
    * 获取年份
@@ -243,40 +243,44 @@ class TzDate {
     return dateFormat(this.#utcDate, "YYYY-MM-DDTHH:mm:ss.SSSZ");
   }
   /**
-   * 创建一个 TzDate 对象
+   * 转换为指定时区的 TimezoneDate 对象
    * @param td - 需要转换的日期对象
    * @param offset - 目标时区分钟偏移量，默认为当前时区
-   * @returns 返回一个 TzDate 对象
+   * @returns 返回一个 TimezoneDate 对象
    * @example
    * ```js
-   * const tzDate = TzDate.from(new TzDate());
+   * // 转换为 UTC 时间
+   * const utc0Td = TimezoneDate.changeUtcOffset(new TimezoneDate(), 0);
+   *
+   * // 转换为东八区时间
+   * const utc8Td = TimezoneDate.changeUtcOffset(new TimezoneDate(), 8);
    * ```
    */
-  static from(td, offset = TzDate.getOffset()) {
-    return new TzDate({
-      offset,
+  static changeUtcOffset(td, utcOffset) {
+    return new TimezoneDate({
+      utcOffset,
       timestamp: td.getTime()
     });
   }
   /**
-   * 获取时区序号
-   * @param offset - 默认使用当前时区分钟偏移量
-   * @returns 时区序号
+   * 获取时区分钟偏移量
+   * @param utcOffset - 默认使用当前时区
+   * @returns 时区分钟偏移量
    */
-  static getOrder(offset = TzDate.getOffset()) {
-    return offset / -60;
+  static getTimezoneOffset(utcOffset) {
+    return isNumber(utcOffset) ? utcOffset * -60 : (/* @__PURE__ */ new Date()).getTimezoneOffset();
   }
   /**
-   * 获取时区分钟偏移量
-   * @param gmtOrder - 默认使用当前时区序号
-   * @returns 时区分钟偏移量
+   * 获取时区序号
+   * @param timezoneOffset - 默认使用当前时区分钟偏移量
+   * @returns 时区序号
    */
-  static getOffset(gmtOrder) {
-    return isNumber(gmtOrder) ? gmtOrder * -60 : (/* @__PURE__ */ new Date()).getTimezoneOffset();
+  static getUTCOffset(timezoneOffset = TimezoneDate.getTimezoneOffset()) {
+    return timezoneOffset / -60;
   }
 }
 function isValidDate(unknown) {
-  return unknown instanceof Date && !Number.isNaN(unknown.getTime()) || unknown instanceof TzDate && !Number.isNaN(unknown.getTime());
+  return unknown instanceof Date && !Number.isNaN(unknown.getTime()) || unknown instanceof TimezoneDate && !Number.isNaN(unknown.getTime());
 }
 function _guessDateSeparator(value) {
   if (!isString(value)) return;
@@ -300,7 +304,7 @@ function _guessDateTimezone(value) {
   return d;
 }
 function dateParse(dateValue) {
-  const d1 = isDate(dateValue) ? new Date(dateValue) : dateValue instanceof TzDate ? new TzDate(dateValue) : new Date(dateValue);
+  const d1 = isDate(dateValue) ? new Date(dateValue) : dateValue instanceof TimezoneDate ? new TimezoneDate(dateValue) : new Date(dateValue);
   if (isValidDate(d1)) return d1;
   const d2 = _guessDateSeparator(dateValue);
   if (isValidDate(d2)) return d2;
@@ -351,7 +355,7 @@ function dateFormat(dateValue, format = "YYYY-MM-DD HH:mm:ss") {
   return result;
 }
 export {
-  TzDate as T,
+  TimezoneDate as T,
   dateFormat as a,
   dateParse as d,
   isValidDate as i

package/dist/core.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"core.mjs","sources":["../src/date/timezone.ts","../src/date/core.ts"],"sourcesContent":["import { isNumber } from '../type';\nimport { dateFormat } from './core';\n\nexport type TzDateOptions = {\n  /**\n   * 时间戳\n   * @default Date.now()\n   */\n  timestamp?: number;\n\n  /**\n   * 日期值\n   */\n  value?: readonly [\n    year?: number,\n    month?: number,\n    day?: number,\n    hours?: number,\n    minutes?: number,\n    seconds?: number,\n    milliseconds?: number,\n  ];\n\n  /**\n   * 时区偏移量，单位为分钟，默认为当前时区\n   */\n  offset?: number;\n};\n\n/**\n * 时区偏移量毫秒常量（1分钟 = 60 * 1000 毫秒）\n */\nconst TZ_OFFSET_MS = 60 * 1000;\n\n/**\n * 时区日期类，用于处理不同时区的日期时间\n */\nexport class TzDate {\n  /**\n   * 内部时间戳\n   */\n  #timestamp: number;\n\n  /**\n   * 目标时区的日期对象\n   */\n  #targetDate: Date;\n\n  /**\n   * UTC 日期对象\n   */\n  #utcDate: Date;\n\n  /**\n   * 本地时区偏移量（分钟）\n   */\n  #localTZOffset = TzDate.getOffset();\n\n  /**\n   * 本地时区偏移量（毫秒）\n   */\n  #localTzOffsetMS = this.#localTZOffset * TZ_OFFSET_MS;\n\n  /**\n   * 目标时区偏移量（分钟）\n   */\n  #targetTzOffset = 0;\n\n  /**\n   * 目标时区偏移量（毫秒）\n   */\n  #targetTzOffsetMS = 0;\n\n  /**\n   * 构造函数选项\n   */\n  #options: TzDateOptions;\n\n  /**\n   * 构造一个 TzDate 实例\n   * @param options - 配置选项\n   */\n  constructor(options?: TzDateOptions | TzDate) {\n    this.#options =\n      (options instanceof TzDate\n        ? {\n            timestamp: options.getTime(),\n            offset: options.getTimezoneOffset(),\n          }\n        : options) || {};\n    const { offset, timestamp, value } = this.#options;\n    this.#targetTzOffset = isNumber(offset) ? offset : this.#localTZOffset;\n    this.#targetTzOffsetMS = this.#targetTzOffset * TZ_OFFSET_MS;\n\n    if (Array.isArray(value) && value.length > 0) {\n      const [fullYear, month, day, hours, minutes, seconds, milliseconds] = value;\n      const timestamp = Date.UTC(\n        fullYear ?? 0,\n        month ?? 0,\n        day ?? 1,\n        hours ?? 0,\n        minutes ?? 0,\n        seconds ?? 0,\n        milliseconds ?? 0,\n      );\n\n      this.#timestamp = timestamp + this.#targetTzOffsetMS;\n    } else {\n      this.#timestamp = timestamp || Date.now();\n    }\n\n    this.#targetDate = new Date(this.#timestamp + this.#localTzOffsetMS - this.#targetTzOffsetMS);\n    this.#utcDate = new Date(this.#timestamp + this.#localTzOffsetMS);\n  }\n\n  /**\n   * 更新内部时间戳\n   */\n  #updateTimestamp() {\n    this.#timestamp = this.#targetDate.getTime() + this.#targetTzOffsetMS - this.#localTzOffsetMS;\n    this.#utcDate = new Date(this.#timestamp + this.#localTzOffsetMS);\n  }\n\n  /**\n   * 获取时区偏移量（分钟）\n   * @returns 时区偏移量\n   */\n  getTimezoneOffset() {\n    return this.#targetTzOffset;\n  }\n\n  /**\n   * 获取时区序号\n   * @returns 时区序号\n   */\n  getTimezoneOrder() {\n    return TzDate.getOrder(this.#targetTzOffset);\n  }\n\n  /**\n   * 获取年份\n   * @returns 年份\n   */\n  getFullYear() {\n    return this.#targetDate.getFullYear();\n  }\n\n  /**\n   * 获取月份\n   * @returns 月份 (0-11)\n   */\n  getMonth() {\n    return this.#targetDate.getMonth();\n  }\n\n  /**\n   * 获取日期\n   * @returns 日期 (1-31)\n   */\n  getDate() {\n    return this.#targetDate.getDate();\n  }\n\n  /**\n   * 获取小时\n   * @returns 小时 (0-23)\n   */\n  getHours() {\n    return this.#targetDate.getHours();\n  }\n\n  /**\n   * 获取分钟\n   * @returns 分钟 (0-59)\n   */\n  getMinutes() {\n    return this.#targetDate.getMinutes();\n  }\n\n  /**\n   * 获取秒数\n   * @returns 秒数 (0-59)\n   */\n  getSeconds() {\n    return this.#targetDate.getSeconds();\n  }\n\n  /**\n   * 获取毫秒\n   * @returns 毫秒 (0-999)\n   */\n  getMilliseconds() {\n    return this.#targetDate.getMilliseconds();\n  }\n\n  /**\n   * 设置年份\n   * @param year - 年份\n   * @param month - 月份\n   * @param date - 日期\n   * @returns 时间戳\n   */\n  setFullYear(year: number, month?: number, date?: number) {\n    this.#targetDate.setFullYear(year);\n    this.#updateTimestamp();\n\n    if (isNumber(month)) this.setMonth(month);\n    if (isNumber(date)) this.setDate(date);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置月份\n   * @param month - 月份\n   * @param date - 日期\n   * @returns 时间戳\n   */\n  setMonth(month: number, date?: number) {\n    this.#targetDate.setMonth(month);\n    this.#updateTimestamp();\n\n    if (isNumber(date)) this.setDate(date);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置日期\n   * @param date - 日期\n   * @returns 时间戳\n   */\n  setDate(date: number) {\n    this.#targetDate.setDate(date);\n    this.#updateTimestamp();\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置小时\n   * @param hours - 小时\n   * @param minutes - 分钟\n   * @param seconds - 秒数\n   * @param milliseconds - 毫秒\n   * @returns 时间戳\n   */\n  setHours(hours: number, minutes?: number, seconds?: number, milliseconds?: number) {\n    this.#targetDate.setHours(hours);\n    this.#updateTimestamp();\n\n    if (isNumber(minutes)) this.setMinutes(minutes);\n    if (isNumber(seconds)) this.setSeconds(seconds);\n    if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置分钟\n   * @param minutes - 分钟\n   * @param seconds - 秒数\n   * @param milliseconds - 毫秒\n   * @returns 时间戳\n   */\n  setMinutes(minutes: number, seconds?: number, milliseconds?: number) {\n    this.#targetDate.setMinutes(minutes);\n    this.#updateTimestamp();\n\n    if (isNumber(seconds)) this.setSeconds(seconds);\n    if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置秒数\n   * @param seconds - 秒数\n   * @param milliseconds - 毫秒\n   * @returns 时间戳\n   */\n  setSeconds(seconds: number, milliseconds?: number) {\n    this.#targetDate.setSeconds(seconds);\n    this.#updateTimestamp();\n\n    if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置毫秒\n   * @param milliseconds - 毫秒\n   * @returns 时间戳\n   */\n  setMilliseconds(milliseconds: number) {\n    this.#targetDate.setMilliseconds(milliseconds);\n    this.#updateTimestamp();\n\n    return this.getTime();\n  }\n\n  /**\n   * 获取时间戳\n   * @returns 时间戳\n   */\n  getTime() {\n    return this.#timestamp;\n  }\n\n  /**\n   * 获取星期几\n   * @returns 星期几 (0-6, 0表示周日)\n   */\n  getDay() {\n    return this.#targetDate.getDay();\n  }\n\n  /**\n   * 转换为 ISO 格式的字符串\n   * @returns ISO 格式的时间字符串\n   */\n  toISOString() {\n    return dateFormat(this.#utcDate, 'YYYY-MM-DDTHH:mm:ss.SSSZ');\n  }\n\n  /**\n   * 创建一个 TzDate 对象\n   * @param td - 需要转换的日期对象\n   * @param offset - 目标时区分钟偏移量，默认为当前时区\n   * @returns 返回一个 TzDate 对象\n   * @example\n   * ```js\n   * const tzDate = TzDate.from(new TzDate());\n   * ```\n   */\n  static from(td: TzDate, offset = TzDate.getOffset()) {\n    return new TzDate({\n      offset: offset,\n      timestamp: td.getTime(),\n    });\n  }\n\n  /**\n   * 获取时区序号\n   * @param offset - 默认使用当前时区分钟偏移量\n   * @returns 时区序号\n   */\n  static getOrder(offset = TzDate.getOffset()) {\n    return offset / -60;\n  }\n\n  /**\n   * 获取时区分钟偏移量\n   * @param gmtOrder - 默认使用当前时区序号\n   * @returns 时区分钟偏移量\n   */\n  static getOffset(gmtOrder?: number) {\n    return isNumber(gmtOrder) ? gmtOrder * -60 : new Date().getTimezoneOffset();\n  }\n}\n","import { objectEach } from '@/object';\nimport { isDate, isString } from '@/type';\nimport { TzDate } from './timezone';\n\n/**\n * 判断一个值是否为有效的日期对象\n * @param unknown - 需要判断的值\n * @returns 如果值是有效的日期对象则返回 true，否则返回 false\n * @example\n * ```typescript\n * isValidDate(new Date()); // true\n * isValidDate('2023-01-01'); // false\n * isValidDate(NaN); // false\n * ```\n */\nexport function isValidDate(unknown: unknown): unknown is Date | TzDate {\n  return (\n    (unknown instanceof Date && !Number.isNaN(unknown.getTime())) ||\n    (unknown instanceof TzDate && !Number.isNaN(unknown.getTime()))\n  );\n}\n\nexport type DateLike = Date | TzDate;\nexport type DateValue = number | string | DateLike;\n\nfunction _guessDateSeparator(value: DateValue): Date | undefined {\n  if (!isString(value)) return;\n\n  const value2 = value.replace(/-/g, '/');\n\n  return new Date(value2);\n}\n\nfunction _guessDateTimezone(value: DateValue): Date | undefined {\n  if (!isString(value)) return;\n\n  const re = /([+-])(\\d\\d)(\\d\\d)$/;\n\n  const matches = re.exec(value);\n\n  if (!matches) return;\n\n  const value2 = value.replace(re, 'Z');\n  const d = new Date(value2);\n\n  if (!isValidDate(d)) return;\n\n  const [, flag, hours, minutes] = matches;\n  const hours2 = Number.parseInt(hours, 10);\n  const minutes2 = Number.parseInt(minutes, 10);\n  const offset = (a: number, b: number): number => (flag === '+' ? a - b : a + b);\n\n  d.setHours(offset(d.getHours(), hours2));\n  d.setMinutes(offset(d.getMinutes(), minutes2));\n\n  return d;\n}\n\n/**\n * 解析为Date对象\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 解析后的 Date 对象\n * @throws {SyntaxError} 如果无法解析为有效的日期对象，则抛出错误\n * @example\n * ```typescript\n * dateParse('2023-01-01'); // Date对象\n * dateParse(1672531200000); // Date对象\n * dateParse(new Date()); // Date对象\n * dateParse('invalid date'); // 抛出 SyntaxError\n * ```\n */\nexport function dateParse(dateValue: DateValue): DateLike {\n  // 传入的 Date 对象有 Date、TzDate\n  // @ts-ignore\n  const d1 = isDate(dateValue)\n    ? new Date(dateValue)\n    : dateValue instanceof TzDate\n      ? new TzDate(dateValue)\n      : new Date(dateValue);\n  if (isValidDate(d1)) return d1;\n\n  // safari 浏览器的日期解析有问题\n  // new Date('2020-06-26 18:06:15') 返回值是一个非法日期对象\n  const d2 = _guessDateSeparator(dateValue);\n  if (isValidDate(d2)) return d2;\n\n  // safari 浏览器的日期解析有问题\n  // new Date('2020-06-26T18:06:15.000+0800') 返回值是一个非法日期对象\n  const d3 = _guessDateTimezone(dateValue);\n  if (isValidDate(d3)) return d3;\n\n  throw new SyntaxError(`${dateValue.toString()} 不是一个合法的日期值`);\n}\n\nfunction _pad(num: number, len = 2) {\n  return `${num}`.padStart(len, '0');\n}\n\nconst rules: [RegExp, (date: DateLike) => number | string][] = [\n  [/Y{4}/gi, (date) => date.getFullYear()],\n  [/Y{2}/gi, (date) => date.getFullYear() % 100],\n  [/M{2}/g, (date) => _pad(date.getMonth() + 1)],\n  [/M{1}/g, (date) => date.getMonth() + 1],\n  [/D{2}/gi, (date) => _pad(date.getDate())],\n  [/D{1}/gi, (date) => date.getDate()],\n  [/H{2}/g, (date) => _pad(date.getHours())],\n  [/H{1}/g, (date) => date.getHours()],\n  [\n    /h{2}/g,\n    (date) => {\n      const h = date.getHours();\n      return _pad(h > 12 ? h - 12 : h);\n    },\n  ],\n  [\n    /h{1}/g,\n    (date) => {\n      const h = date.getHours();\n      return h > 12 ? h - 12 : h;\n    },\n  ],\n  [/m{2}/g, (date) => _pad(date.getMinutes())],\n  [/m{1}/g, (date) => date.getMinutes()],\n  [/s{2}/g, (date) => _pad(date.getSeconds())],\n  [/s{1}/g, (date) => date.getSeconds()],\n  [/S{3}/g, (date) => _pad(date.getMilliseconds(), 3)],\n  [/S{2}/g, (date) => _pad(date.getMilliseconds(), 2)],\n  [/S{1}/g, (date) => date.getMilliseconds()],\n];\n\n/**\n * 格式化为日期字符串(带自定义格式化模板)\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param format - 模板，默认是 'YYYY-MM-DD HH:mm:ss'，模板字符：\n * - YYYY：年\n * - yyyy: 年\n * - MM：月\n * - DD：日\n * - dd: 日\n * - HH：时（24 小时制）\n * - hh：时（12 小时制）\n * - mm：分\n * - ss：秒\n * - SSS：毫秒\n * @returns 格式化后的日期字符串\n * @example\n * ```typescript\n * dateFormat(new Date(), 'YYYY-MM-DD'); // '2023-01-01'\n * dateFormat(1672531200000, 'YYYY/MM/DD HH:mm:ss'); // '2023/01/01 00:00:00'\n * dateFormat('2023-01-01', 'YYYY年MM月DD日'); // '2023年01月01日'\n * ```\n */\nexport function dateFormat(dateValue: DateValue, format = 'YYYY-MM-DD HH:mm:ss'): string {\n  const date = dateParse(dateValue);\n  let result = format;\n\n  for (const rule of rules) {\n    result = result.replace(rule[0], String(rule[1](date)));\n  }\n\n  return result;\n}\n"],"names":["timestamp"],"mappings":"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"}
+{"version":3,"file":"core.mjs","sources":["../src/date/timezone.ts","../src/date/core.ts"],"sourcesContent":["import { isNumber } from '../type';\nimport { dateFormat } from './core';\n\nexport type TimezoneDateOptions = {\n  /**\n   * 时间戳\n   * @default Date.now()\n   */\n  timestamp?: number;\n\n  /**\n   * 日期值\n   */\n  value?: readonly [\n    year?: number,\n    month?: number,\n    day?: number,\n    hours?: number,\n    minutes?: number,\n    seconds?: number,\n    milliseconds?: number,\n  ];\n\n  /**\n   * UTC 时区，支持负数和小数，例如：\n   * - 8 表示 UTC+8\n   * - -12 表示 UTC-12\n   * - 0 表示 UTC 时间\n   * - 12.5 表示 UTC+12:30\n   */\n  utcOffset?: number;\n};\n\n/**\n * 时区偏移量毫秒常量（1分钟 = 60 * 1000 毫秒）\n */\nconst TIMEZONE_OFFSET_MS = 60 * 1000;\n\n/**\n * 时区日期类，用于处理不同时区的日期时间\n */\nexport class TimezoneDate {\n  /**\n   * 内部时间戳\n   */\n  #timestamp: number;\n\n  /**\n   * 目标时区的日期对象\n   */\n  #targetDate: Date;\n\n  /**\n   * UTC 日期对象\n   */\n  #utcDate: Date;\n\n  /**\n   * 本地时区偏移量（分钟）\n   */\n  #localTimezoneOffset = TimezoneDate.getTimezoneOffset();\n\n  /**\n   * 本地时区偏移量（毫秒）\n   */\n  #localTimezoneOffsetMS = this.#localTimezoneOffset * TIMEZONE_OFFSET_MS;\n\n  /**\n   * 目标时区偏移量（分钟）\n   */\n  #targetTimezoneOffset = 0;\n\n  /**\n   * 目标时区偏移量（毫秒）\n   */\n  #targetTimezoneOffsetMS = 0;\n\n  /**\n   * 构造函数选项\n   */\n  #options: TimezoneDateOptions;\n\n  /**\n   * 构造一个 TimezoneDate 实例\n   * @param options - 配置选项\n   */\n  constructor(options?: TimezoneDateOptions | TimezoneDate) {\n    this.#options =\n      (options instanceof TimezoneDate\n        ? {\n            timestamp: options.getTime(),\n            utcOffset: options.getUTCOffset(),\n          }\n        : options) || {};\n    const { utcOffset, timestamp, value } = this.#options;\n    this.#targetTimezoneOffset = isNumber(utcOffset)\n      ? TimezoneDate.getTimezoneOffset(utcOffset)\n      : this.#localTimezoneOffset;\n    this.#targetTimezoneOffsetMS = this.#targetTimezoneOffset * TIMEZONE_OFFSET_MS;\n\n    if (Array.isArray(value) && value.length > 0) {\n      const [fullYear, month, day, hours, minutes, seconds, milliseconds] = value;\n      const timestamp = Date.UTC(\n        fullYear ?? 0,\n        month ?? 0,\n        day ?? 1,\n        hours ?? 0,\n        minutes ?? 0,\n        seconds ?? 0,\n        milliseconds ?? 0,\n      );\n\n      this.#timestamp = timestamp + this.#targetTimezoneOffsetMS;\n    } else {\n      this.#timestamp = timestamp || Date.now();\n    }\n\n    this.#targetDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS - this.#targetTimezoneOffsetMS);\n    this.#utcDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS);\n  }\n\n  /**\n   * 更新内部时间戳\n   */\n  #updateTimestamp() {\n    this.#timestamp = this.#targetDate.getTime() + this.#targetTimezoneOffsetMS - this.#localTimezoneOffsetMS;\n    this.#utcDate = new Date(this.#timestamp + this.#localTimezoneOffsetMS);\n  }\n\n  /**\n   * 获取时区偏移量（分钟）\n   * @returns 时区偏移量\n   */\n  getTimezoneOffset() {\n    return this.#targetTimezoneOffset;\n  }\n\n  /**\n   * 获取时区偏移量（UTC）\n   * @returns 时区序号\n   */\n  getUTCOffset() {\n    return TimezoneDate.getUTCOffset(this.#targetTimezoneOffset);\n  }\n\n  /**\n   * 获取年份\n   * @returns 年份\n   */\n  getFullYear() {\n    return this.#targetDate.getFullYear();\n  }\n\n  /**\n   * 获取月份\n   * @returns 月份 (0-11)\n   */\n  getMonth() {\n    return this.#targetDate.getMonth();\n  }\n\n  /**\n   * 获取日期\n   * @returns 日期 (1-31)\n   */\n  getDate() {\n    return this.#targetDate.getDate();\n  }\n\n  /**\n   * 获取小时\n   * @returns 小时 (0-23)\n   */\n  getHours() {\n    return this.#targetDate.getHours();\n  }\n\n  /**\n   * 获取分钟\n   * @returns 分钟 (0-59)\n   */\n  getMinutes() {\n    return this.#targetDate.getMinutes();\n  }\n\n  /**\n   * 获取秒数\n   * @returns 秒数 (0-59)\n   */\n  getSeconds() {\n    return this.#targetDate.getSeconds();\n  }\n\n  /**\n   * 获取毫秒\n   * @returns 毫秒 (0-999)\n   */\n  getMilliseconds() {\n    return this.#targetDate.getMilliseconds();\n  }\n\n  /**\n   * 设置年份\n   * @param year - 年份\n   * @param month - 月份\n   * @param date - 日期\n   * @returns 时间戳\n   */\n  setFullYear(year: number, month?: number, date?: number) {\n    this.#targetDate.setFullYear(year);\n    this.#updateTimestamp();\n\n    if (isNumber(month)) this.setMonth(month);\n    if (isNumber(date)) this.setDate(date);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置月份\n   * @param month - 月份\n   * @param date - 日期\n   * @returns 时间戳\n   */\n  setMonth(month: number, date?: number) {\n    this.#targetDate.setMonth(month);\n    this.#updateTimestamp();\n\n    if (isNumber(date)) this.setDate(date);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置日期\n   * @param date - 日期\n   * @returns 时间戳\n   */\n  setDate(date: number) {\n    this.#targetDate.setDate(date);\n    this.#updateTimestamp();\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置小时\n   * @param hours - 小时\n   * @param minutes - 分钟\n   * @param seconds - 秒数\n   * @param milliseconds - 毫秒\n   * @returns 时间戳\n   */\n  setHours(hours: number, minutes?: number, seconds?: number, milliseconds?: number) {\n    this.#targetDate.setHours(hours);\n    this.#updateTimestamp();\n\n    if (isNumber(minutes)) this.setMinutes(minutes);\n    if (isNumber(seconds)) this.setSeconds(seconds);\n    if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置分钟\n   * @param minutes - 分钟\n   * @param seconds - 秒数\n   * @param milliseconds - 毫秒\n   * @returns 时间戳\n   */\n  setMinutes(minutes: number, seconds?: number, milliseconds?: number) {\n    this.#targetDate.setMinutes(minutes);\n    this.#updateTimestamp();\n\n    if (isNumber(seconds)) this.setSeconds(seconds);\n    if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置秒数\n   * @param seconds - 秒数\n   * @param milliseconds - 毫秒\n   * @returns 时间戳\n   */\n  setSeconds(seconds: number, milliseconds?: number) {\n    this.#targetDate.setSeconds(seconds);\n    this.#updateTimestamp();\n\n    if (isNumber(milliseconds)) this.setMilliseconds(milliseconds);\n\n    return this.getTime();\n  }\n\n  /**\n   * 设置毫秒\n   * @param milliseconds - 毫秒\n   * @returns 时间戳\n   */\n  setMilliseconds(milliseconds: number) {\n    this.#targetDate.setMilliseconds(milliseconds);\n    this.#updateTimestamp();\n\n    return this.getTime();\n  }\n\n  /**\n   * 获取时间戳\n   * @returns 时间戳\n   */\n  getTime() {\n    return this.#timestamp;\n  }\n\n  /**\n   * 获取星期几\n   * @returns 星期几 (0-6, 0表示周日)\n   */\n  getDay() {\n    return this.#targetDate.getDay();\n  }\n\n  /**\n   * 转换为 ISO 格式的字符串\n   * @returns ISO 格式的时间字符串\n   */\n  toISOString() {\n    return dateFormat(this.#utcDate, 'YYYY-MM-DDTHH:mm:ss.SSSZ');\n  }\n\n  /**\n   * 转换为指定时区的 TimezoneDate 对象\n   * @param td - 需要转换的日期对象\n   * @param offset - 目标时区分钟偏移量，默认为当前时区\n   * @returns 返回一个 TimezoneDate 对象\n   * @example\n   * ```js\n   * // 转换为 UTC 时间\n   * const utc0Td = TimezoneDate.changeUtcOffset(new TimezoneDate(), 0);\n   *\n   * // 转换为东八区时间\n   * const utc8Td = TimezoneDate.changeUtcOffset(new TimezoneDate(), 8);\n   * ```\n   */\n  static changeUtcOffset(td: TimezoneDate, utcOffset: number) {\n    return new TimezoneDate({\n      utcOffset,\n      timestamp: td.getTime(),\n    });\n  }\n\n  /**\n   * 获取时区分钟偏移量\n   * @param utcOffset - 默认使用当前时区\n   * @returns 时区分钟偏移量\n   */\n  static getTimezoneOffset(utcOffset?: number) {\n    return isNumber(utcOffset) ? utcOffset * -60 : new Date().getTimezoneOffset();\n  }\n\n  /**\n   * 获取时区序号\n   * @param timezoneOffset - 默认使用当前时区分钟偏移量\n   * @returns 时区序号\n   */\n  static getUTCOffset(timezoneOffset = TimezoneDate.getTimezoneOffset()) {\n    return timezoneOffset / -60;\n  }\n}\n","import { objectEach } from '@/object';\nimport { isDate, isString } from '@/type';\nimport { TimezoneDate } from './timezone';\n\n/**\n * 判断一个值是否为有效的日期对象\n * @param unknown - 需要判断的值\n * @returns 如果值是有效的日期对象则返回 true，否则返回 false\n * @example\n * ```typescript\n * isValidDate(new Date()); // true\n * isValidDate('2023-01-01'); // false\n * isValidDate(NaN); // false\n * ```\n */\nexport function isValidDate(unknown: unknown): unknown is Date | TimezoneDate {\n  return (\n    (unknown instanceof Date && !Number.isNaN(unknown.getTime())) ||\n    (unknown instanceof TimezoneDate && !Number.isNaN(unknown.getTime()))\n  );\n}\n\nexport type DateLike = Date | TimezoneDate;\nexport type DateValue = number | string | DateLike;\n\nfunction _guessDateSeparator(value: DateValue): Date | undefined {\n  if (!isString(value)) return;\n\n  const value2 = value.replace(/-/g, '/');\n\n  return new Date(value2);\n}\n\nfunction _guessDateTimezone(value: DateValue): Date | undefined {\n  if (!isString(value)) return;\n\n  const re = /([+-])(\\d\\d)(\\d\\d)$/;\n\n  const matches = re.exec(value);\n\n  if (!matches) return;\n\n  const value2 = value.replace(re, 'Z');\n  const d = new Date(value2);\n\n  if (!isValidDate(d)) return;\n\n  const [, flag, hours, minutes] = matches;\n  const hours2 = Number.parseInt(hours, 10);\n  const minutes2 = Number.parseInt(minutes, 10);\n  const offset = (a: number, b: number): number => (flag === '+' ? a - b : a + b);\n\n  d.setHours(offset(d.getHours(), hours2));\n  d.setMinutes(offset(d.getMinutes(), minutes2));\n\n  return d;\n}\n\n/**\n * 解析为Date对象\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @returns 解析后的 Date 对象\n * @throws {SyntaxError} 如果无法解析为有效的日期对象，则抛出错误\n * @example\n * ```typescript\n * dateParse('2023-01-01'); // Date对象\n * dateParse(1672531200000); // Date对象\n * dateParse(new Date()); // Date对象\n * dateParse('invalid date'); // 抛出 SyntaxError\n * ```\n */\nexport function dateParse(dateValue: DateValue): DateLike {\n  // 传入的 Date 对象有 Date、TimezoneDate\n  // @ts-ignore\n  const d1 = isDate(dateValue)\n    ? new Date(dateValue)\n    : dateValue instanceof TimezoneDate\n      ? new TimezoneDate(dateValue)\n      : new Date(dateValue);\n  if (isValidDate(d1)) return d1;\n\n  // safari 浏览器的日期解析有问题\n  // new Date('2020-06-26 18:06:15') 返回值是一个非法日期对象\n  const d2 = _guessDateSeparator(dateValue);\n  if (isValidDate(d2)) return d2;\n\n  // safari 浏览器的日期解析有问题\n  // new Date('2020-06-26T18:06:15.000+0800') 返回值是一个非法日期对象\n  const d3 = _guessDateTimezone(dateValue);\n  if (isValidDate(d3)) return d3;\n\n  throw new SyntaxError(`${dateValue.toString()} 不是一个合法的日期值`);\n}\n\nfunction _pad(num: number, len = 2) {\n  return `${num}`.padStart(len, '0');\n}\n\nconst rules: [RegExp, (date: DateLike) => number | string][] = [\n  [/Y{4}/gi, (date) => date.getFullYear()],\n  [/Y{2}/gi, (date) => date.getFullYear() % 100],\n  [/M{2}/g, (date) => _pad(date.getMonth() + 1)],\n  [/M{1}/g, (date) => date.getMonth() + 1],\n  [/D{2}/gi, (date) => _pad(date.getDate())],\n  [/D{1}/gi, (date) => date.getDate()],\n  [/H{2}/g, (date) => _pad(date.getHours())],\n  [/H{1}/g, (date) => date.getHours()],\n  [\n    /h{2}/g,\n    (date) => {\n      const h = date.getHours();\n      return _pad(h > 12 ? h - 12 : h);\n    },\n  ],\n  [\n    /h{1}/g,\n    (date) => {\n      const h = date.getHours();\n      return h > 12 ? h - 12 : h;\n    },\n  ],\n  [/m{2}/g, (date) => _pad(date.getMinutes())],\n  [/m{1}/g, (date) => date.getMinutes()],\n  [/s{2}/g, (date) => _pad(date.getSeconds())],\n  [/s{1}/g, (date) => date.getSeconds()],\n  [/S{3}/g, (date) => _pad(date.getMilliseconds(), 3)],\n  [/S{2}/g, (date) => _pad(date.getMilliseconds(), 2)],\n  [/S{1}/g, (date) => date.getMilliseconds()],\n];\n\n/**\n * 格式化为日期字符串(带自定义格式化模板)\n * @param dateValue - 可以是数值、字符串或 Date 对象\n * @param format - 模板，默认是 'YYYY-MM-DD HH:mm:ss'，模板字符：\n * - YYYY：年\n * - yyyy: 年\n * - MM：月\n * - DD：日\n * - dd: 日\n * - HH：时（24 小时制）\n * - hh：时（12 小时制）\n * - mm：分\n * - ss：秒\n * - SSS：毫秒\n * @returns 格式化后的日期字符串\n * @example\n * ```typescript\n * dateFormat(new Date(), 'YYYY-MM-DD'); // '2023-01-01'\n * dateFormat(1672531200000, 'YYYY/MM/DD HH:mm:ss'); // '2023/01/01 00:00:00'\n * dateFormat('2023-01-01', 'YYYY年MM月DD日'); // '2023年01月01日'\n * ```\n */\nexport function dateFormat(dateValue: DateValue, format = 'YYYY-MM-DD HH:mm:ss'): string {\n  const date = dateParse(dateValue);\n  let result = format;\n\n  for (const rule of rules) {\n    result = result.replace(rule[0], String(rule[1](date)));\n  }\n\n  return result;\n}\n"],"names":["timestamp"],"mappings":"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"}

package/dist/date/core.d.ts

@@ -1,4 +1,4 @@
-import { TzDate } from './timezone';
+import { TimezoneDate } from './timezone';
 /**
  * 判断一个值是否为有效的日期对象
  * @param unknown - 需要判断的值
@@ -10,8 +10,8 @@ import { TzDate } from './timezone';
  * isValidDate(NaN); // false
  * ```
  */
-export declare function isValidDate(unknown: unknown): unknown is Date | TzDate;
-export type DateLike = Date | TzDate;
+export declare function isValidDate(unknown: unknown): unknown is Date | TimezoneDate;
+export type DateLike = Date | TimezoneDate;
 export type DateValue = number | string | DateLike;
 /**
  * 解析为Date对象

package/dist/date/timezone.d.ts

@@ -1,4 +1,4 @@
-export type TzDateOptions = {
+export type TimezoneDateOptions = {
     /**
      * 时间戳
      * @default Date.now()
@@ -17,30 +17,34 @@ export type TzDateOptions = {
         milliseconds?: number
     ];
     /**
-     * 时区偏移量，单位为分钟，默认为当前时区
+     * UTC 时区，支持负数和小数，例如：
+     * - 8 表示 UTC+8
+     * - -12 表示 UTC-12
+     * - 0 表示 UTC 时间
+     * - 12.5 表示 UTC+12:30
      */
-    offset?: number;
+    utcOffset?: number;
 };
 /**
  * 时区日期类，用于处理不同时区的日期时间
  */
-export declare class TzDate {
+export declare class TimezoneDate {
     #private;
     /**
-     * 构造一个 TzDate 实例
+     * 构造一个 TimezoneDate 实例
      * @param options - 配置选项
      */
-    constructor(options?: TzDateOptions | TzDate);
+    constructor(options?: TimezoneDateOptions | TimezoneDate);
     /**
      * 获取时区偏移量（分钟）
      * @returns 时区偏移量
      */
     getTimezoneOffset(): number;
     /**
-     * 获取时区序号
+     * 获取时区偏移量（UTC）
      * @returns 时区序号
      */
-    getTimezoneOrder(): number;
+    getUTCOffset(): number;
     /**
      * 获取年份
      * @returns 年份
@@ -143,26 +147,30 @@ export declare class TzDate {
      */
     toISOString(): string;
     /**
-     * 创建一个 TzDate 对象
+     * 转换为指定时区的 TimezoneDate 对象
      * @param td - 需要转换的日期对象
      * @param offset - 目标时区分钟偏移量，默认为当前时区
-     * @returns 返回一个 TzDate 对象
+     * @returns 返回一个 TimezoneDate 对象
      * @example
      * ```js
-     * const tzDate = TzDate.from(new TzDate());
+     * // 转换为 UTC 时间
+     * const utc0Td = TimezoneDate.changeUtcOffset(new TimezoneDate(), 0);
+     *
+     * // 转换为东八区时间
+     * const utc8Td = TimezoneDate.changeUtcOffset(new TimezoneDate(), 8);
      * ```
      */
-    static from(td: TzDate, offset?: number): TzDate;
-    /**
-     * 获取时区序号
-     * @param offset - 默认使用当前时区分钟偏移量
-     * @returns 时区序号
-     */
-    static getOrder(offset?: number): number;
+    static changeUtcOffset(td: TimezoneDate, utcOffset: number): TimezoneDate;
     /**
      * 获取时区分钟偏移量
-     * @param gmtOrder - 默认使用当前时区序号
+     * @param utcOffset - 默认使用当前时区
      * @returns 时区分钟偏移量
      */
-    static getOffset(gmtOrder?: number): number;
+    static getTimezoneOffset(utcOffset?: number): number;
+    /**
+     * 获取时区序号
+     * @param timezoneOffset - 默认使用当前时区分钟偏移量
+     * @returns 时区序号
+     */
+    static getUTCOffset(timezoneOffset?: number): number;
 }

package/dist/date.cjs

@@ -206,7 +206,7 @@ exports.DATE_MINUTE_MS = _const.DATE_MINUTE_MS;
 exports.DATE_MONTH_MS = _const.DATE_MONTH_MS;
 exports.DATE_SECOND_MS = _const.DATE_SECOND_MS;
 exports.DATE_YEAR_MS = _const.DATE_YEAR_MS;
-exports.TzDate = core.TzDate;
+exports.TimezoneDate = core.TimezoneDate;
 exports.dateFormat = core.dateFormat;
 exports.dateParse = core.dateParse;
 exports.isValidDate = core.isValidDate;

package/dist/date.mjs

@@ -208,7 +208,7 @@ export {
   e as DATE_SECOND_MS,
   D as DATE_YEAR_MS,
   EWeekStart,
-  T as TzDate,
+  T as TimezoneDate,
   _dateWeeks,
   dateDaysInMonth,
   dateDaysInYear,

package/dist/index.cjs

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const VERSION = "1.15.7";
+const VERSION = "1.16.0";
 exports.VERSION = VERSION;
 //# sourceMappingURL=index.cjs.map

package/dist/index.mjs

@@ -1,4 +1,4 @@
-const VERSION = "1.15.7";
+const VERSION = "1.16.0";
 export {
   VERSION
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudcome/utils-core",
-  "version": "1.16.0",
+  "version": "1.17.0",
   "description": "cloudcome core utils",
   "engines": {
     "node": ">=22"