答案。

问题历史：

在 JavaScript 中，Date 对象用于表示日期和时间，并以其特定的工作方式而闻名——可变性、解析复杂性和时区特性。TypeScript 对 Date 使用标准 JS 类型，但在严格代码中对日期的类型化和处理需要特别的方法。

问题：

JavaScript 中的 Date 是一个可变对象，可能会产生非典型错误（例如，setMonth() 会改变对象本身，从而导致代码的意外行为）。此外，与外部库（moment.js、date-fns、Day.js 等）的集成要求准确的类型匹配——例如，moment.Instant 或特定的时间包装器之间不兼容。有时返回的类型可能是 string 或 number（时间戳），这会导致在类型注释或使用 API 时出现错误。

解决方案：

TypeScript 将新的 Date 实例类型化为 Date，所有方法均可用。在与其他库集成时，务必仔细监控输入和输出值的类型——使用显式转换为 Date（例如，new Date(value)），或者创建用于日期和时间的用户自定义容器类型。要在时间戳（number）、字符串和 Date 对象之间进行转换，需要严格指定类型，并用类型或接口描述函数。

代码示例：

function toIsoString(d: Date | number | string): string {
  if (d instanceof Date) return d.toISOString();
  if (typeof d === 'number' || typeof d === 'string') return new Date(d).toISOString();
  throw new Error('无效日期');
}

关键特点：

Date 是一个可变对象，不是值类型，而是引用类型。
从 API 或第三方库接收和返回日期时，需要严格保持类型兼容性。
外部包装器如 moment、dayjs 需要显式自定义类型和/或类型保护函数。

具有陷阱的问题。

TypeScript 中的 "Date" 类型是简单的值类型吗？

不，Date 是一个对象，即引用类型。通过 == 或 === 比较日期不会比较值，只比较引用。

const d1 = new Date('2022-01-01');
const d2 = new Date('2022-01-01');
d1 === d2; // false

可以直接将字符串或数字赋值给 Date 类型而不进行新的初始化吗？

不，Date 类型与 number 或 string 不兼容。需要创建新的实例：new Date(value)。

const d: Date = new Date('2020-01-01');
// const d2: Date = '2020-01-01'; // 类型错误

接受 Date 的函数能否与外部库的对象（moment、dayjs）一起工作？

不，除非库中明确实现了通过 valueOf/toDate 对 Date 进行转换/兼容，否则这是不同的类型，TypeScript 不会将它们视为 Date。

import dayjs from "dayjs";
function doSomething(d: Date) { /* ... */ }
doSomething(dayjs()); // 错误，因为 Dayjs 类型与 Date 不兼容

类型错误和反模式

在与 API 集成时对日期使用任何类型（any）。
在传递 Date 对象给多个函数时对其进行变更（set*、setUTC*）——存在风险竞争条件。
类型不兼容：尝试将外部类型视为 Date 进行操作。

生活中的实例

消极案例

代码将参数视为 any，之后假设这是 Date。实际 API 返回时间戳为字符串，这在调用 .getFullYear() 时引发了错误。

优点：

在没有编译错误的情况下 "随便工作"。

缺点：

风险运行时错误。
在生产环境中排除错误的困难。

积极案例

开发人员为参数创建了明确类型（Date | string | number），引入了类型保护，并在函数中明确调用了 new Date。编译器强制要求明确处理所有类型。