refactor(date): 重命名 TzDate 为 TimezoneDate 并统一时区相关接口

Author: cloudcome

packages/utils-core/test/date-tz.test.ts

@@ -1,15 +1,15 @@
 import { dateFormat } from '@/date';
-import { TzDate } from '@/date';
+import { TimezoneDate } from '@/date';
 
-const gmtOrder = TzDate.getOrder();
-console.log(`当前时区 GMT${gmtOrder > 0 ? '+' : ''}${gmtOrder}`);
+const utcOrder = TimezoneDate.getUTCOffset();
+console.log(`当前时区 GMT${utcOrder > 0 ? '+' : ''}${utcOrder}`);
 
 describe('0 时区', () => {
-  const offset = TzDate.getOffset(0);
+  const utcOffset = 0;
 
   it('空入参', () => {
     // 时间戳与时区无关
-    const tzNow = new TzDate({ offset }).getTime();
+    const tzNow = new TimezoneDate({ utcOffset }).getTime();
     const now = new Date().getTime();
     expect(tzNow).toBeLessThanOrEqual(now);
     // 误差小于 10ms
@@ -19,18 +19,18 @@ describe('0 时区', () => {
   it('时间戳', () => {
     // 时间戳与时区无关
     const now = Date.now();
-    const td = new TzDate({ offset, timestamp: now });
+    const td = new TimezoneDate({ utcOffset, timestamp: now });
     const dt = new Date(now);
 
     expect(td.getTime()).toBe(dt.getTime());
-    expect(td.getTimezoneOrder()).toBe(0);
+    expect(td.getUTCOffset()).toBe(0);
   });
 
   it('年月日', () => {
     const localOffset = new Date().getTimezoneOffset() * 60 * 1000;
     const targetOffset = 0;
     const value = [2025, 5, 3, 12, 34, 56, 789] as const;
-    const td = new TzDate({ offset, value });
+    const td = new TimezoneDate({ utcOffset, value });
 
     expect(td.toISOString()).toEqual('2025-06-03T12:34:56.789Z');
 
@@ -79,11 +79,11 @@ describe('0 时区', () => {
 });
 
 describe('东 8 时区', () => {
-  const offset = TzDate.getOffset(8);
+  const utcOffset = 8;
 
   it('空入参', () => {
     // 时间戳与时区无关
-    const tzNow = new TzDate({ offset }).getTime();
+    const tzNow = new TimezoneDate({ utcOffset }).getTime();
     const now = new Date().getTime();
     expect(tzNow).toBeLessThanOrEqual(now);
     // 误差小于 10ms
@@ -93,18 +93,18 @@ describe('东 8 时区', () => {
   it('时间戳', () => {
     // 时间戳与时区无关
     const now = Date.now();
-    const td = new TzDate({ offset, timestamp: now });
+    const td = new TimezoneDate({ utcOffset, timestamp: now });
     const dt = new Date(now);
 
     expect(td.getTime()).toBe(dt.getTime());
-    expect(td.getTimezoneOrder()).toBe(8);
+    expect(td.getUTCOffset()).toBe(8);
   });
 
   it('年月日', () => {
     const localOffset = new Date().getTimezoneOffset() * 60 * 1000;
-    const targetOffset = offset * 60 * 1000;
+    const targetOffset = TimezoneDate.getTimezoneOffset(utcOffset) * 60 * 1000;
     const value = [2025, 5, 3, 12, 34, 56, 789] as const;
-    const td = new TzDate({ offset, value: [...value] });
+    const td = new TimezoneDate({ utcOffset, value });
 
     expect(td.toISOString()).toEqual('2025-06-03T04:34:56.789Z');
 
@@ -124,101 +124,88 @@ describe('东 8 时区', () => {
 
     td.setFullYear(2024);
     expect(td.getFullYear()).toBe(2024);
-    expect(td.getTime()).toEqual(getUtcTimestamp(td, offset));
+    expect(td.getTime()).toEqual(getUtcTimestamp(td, utcOffset));
 
     td.setMonth(5);
     expect(td.getMonth()).toBe(5);
-    expect(td.getTime()).toEqual(getUtcTimestamp(td, offset));
+    expect(td.getTime()).toEqual(getUtcTimestamp(td, utcOffset));
 
     td.setDate(10);
     expect(td.getDate()).toBe(10);
-    expect(td.getTime()).toEqual(getUtcTimestamp(td, offset));
+    expect(td.getTime()).toEqual(getUtcTimestamp(td, utcOffset));
 
     td.setHours(12);
     expect(td.getHours()).toBe(12);
-    expect(td.getTime()).toEqual(getUtcTimestamp(td, offset));
+    expect(td.getTime()).toEqual(getUtcTimestamp(td, utcOffset));
 
     td.setMinutes(30);
     expect(td.getMinutes()).toBe(30);
-    expect(td.getTime()).toEqual(getUtcTimestamp(td, offset));
+    expect(td.getTime()).toEqual(getUtcTimestamp(td, utcOffset));
 
     td.setSeconds(45);
     expect(td.getSeconds()).toBe(45);
-    expect(td.getTime()).toEqual(getUtcTimestamp(td, offset));
+    expect(td.getTime()).toEqual(getUtcTimestamp(td, utcOffset));
 
     td.setMilliseconds(100);
     expect(td.getMilliseconds()).toBe(100);
-    expect(td.getTime()).toEqual(getUtcTimestamp(td, offset));
+    expect(td.getTime()).toEqual(getUtcTimestamp(td, utcOffset));
   });
 });
 
 describe('时区转换', () => {
   it('时间戳', () => {
     const timestamp = Date.now();
-    const gmt8Date = new TzDate({
-      offset: TzDate.getOffset(8),
+    const utc8Date = new TimezoneDate({
+      utcOffset: 8,
       timestamp,
     });
-    const gmt0Date = TzDate.from(gmt8Date, 0);
+    const utc0Date = TimezoneDate.changeUtcOffset(utc8Date, 0);
 
-    console.log('gmt8:', dateFormat(gmt8Date));
-    console.log('gmt0:', dateFormat(gmt0Date));
+    console.log('utc8:', dateFormat(utc8Date));
+    console.log('utc0:', dateFormat(utc0Date));
 
-    let gmt8Hours = gmt8Date.getHours();
-    const gmt0Hours = gmt0Date.getHours();
+    let utc8Hours = utc8Date.getHours();
+    const utc0Hours = utc0Date.getHours();
 
     // 不是同一天
-    if (gmt8Date.getDate() !== gmt0Date.getDate()) {
-      gmt8Hours += 24;
+    if (utc8Date.getDate() !== utc0Date.getDate()) {
+      utc8Hours += 24;
     }
 
-    expect(gmt8Hours - gmt0Hours).toBe(8);
-    expect(gmt0Date.getTime()).toBe(gmt0Date.getTime());
+    expect(utc8Hours - utc0Hours).toBe(8);
+    expect(utc0Date.getTime()).toBe(utc0Date.getTime());
   });
 
   it('日期', () => {
     const value = [2024, 5, 10, 12, 30, 45, 100] as const;
-    const gmt8Td = new TzDate({
-      offset: TzDate.getOffset(8),
+    const utc8Td = new TimezoneDate({
+      utcOffset: 8,
       value,
     });
-    const gmt0Td = TzDate.from(gmt8Td, 0);
+    const utc0Td = TimezoneDate.changeUtcOffset(utc8Td, 0);
 
-    expect(gmt8Td.getHours()).toBe(12);
-    expect(gmt0Td.getHours()).toBe(4);
-    expect(gmt0Td.getTime()).toBe(gmt0Td.getTime());
+    expect(utc8Td.getHours()).toBe(12);
+    expect(utc0Td.getHours()).toBe(4);
+    expect(utc0Td.getTime()).toBe(utc0Td.getTime());
   });
 });
 
 describe('时间转换', () => {
-  it('from 时间转换后', () => {
-    const td1 = new TzDate({
-      offset: TzDate.getOffset(8),
-      value: [2024, 5, 10, 12, 30, 45, 100] as const,
-    });
-
-    td1.setDate(td1.getDate() - 1);
-    expect(td1.getDate()).toBe(9);
-
-    const td2 = TzDate.from(td1, td1.getTimezoneOffset());
-    expect(td2.getDate()).toBe(9);
-  });
-
   it('new 时间转换后', () => {
-    const td1 = new TzDate({
-      offset: TzDate.getOffset(8),
+    const td1 = new TimezoneDate({
+      utcOffset: 8,
       value: [2024, 5, 10, 12, 30, 45, 100] as const,
     });
 
     td1.setDate(td1.getDate() - 1);
     expect(td1.getDate()).toBe(9);
 
-    const td2 = new TzDate(td1);
+    const td2 = new TimezoneDate(td1);
     expect(td2.getDate()).toBe(9);
   });
 });
 
-function getUtcTimestamp(td: TzDate, offset = 0) {
+function getUtcTimestamp(td: TimezoneDate, utcOffset = 0) {
   return (
     Date.UTC(
       td.getFullYear(),
@@ -229,6 +216,6 @@ function getUtcTimestamp(td: TzDate, offset = 0) {
       td.getSeconds(),
       td.getMilliseconds(),
     ) +
-    offset * 60 * 1000
+    TimezoneDate.getTimezoneOffset(utcOffset) * 60 * 1000
   );
 }