TypeScript中Date.getTime()非函数报错排查：参数类型异常解析

嘿，这个坑我之前踩过！核心问题是你代码里的someObject.createdTime虽然TypeScript标注成了Date类型，但它在运行时根本不是一个真正的Date实例——这就是为什么调用getTime()和toUTCString()都会报错的原因。

为什么会出现这种情况？ #

最常见的场景是：someObject是从API接口、JSON文件或者本地存储中获取的。在序列化/反序列化过程中，Date对象会被自动转换成ISO格式的字符串（比如"2024-05-20T14:30:00.000Z"），但你的TypeScript类型定义错误地把它标注成了Date，导致编译时不报错，但运行时暴露问题。

先验证一下我的猜测 #

你可以在调用getPeriod之前加两行调试代码，确认createdTime的真实类型：

console.log(typeof someObject.createdTime); // 大概率会输出 "string"
console.log(someObject.createdTime); // 会看到类似上面的ISO字符串

解决方法 #

这里有两种可靠的修复思路：

方法一：在传参前转成真正的Date实例

直接把字符串转成Date再传入函数，同时做格式校验避免无效日期：

// 先转换
const createdDate = new Date(someObject.createdTime);
// 校验日期有效性
if (!isNaN(createdDate.getTime())) {
  const period = self.getPeriod(createdDate);
  // 继续你的业务逻辑
} else {
  console.error("无效的日期格式：", someObject.createdTime);
}

方法二：让函数兼容Date和string类型

修改getPeriod的参数类型，让它同时支持Date和字符串，内部自动处理转换：

getPeriod(date: Date | string) {
  // 统一转成Date实例
  const validDate = typeof date === 'string' ? new Date(date) : date;
  // 校验有效性
  if (isNaN(validDate.getTime())) {
    throw new Error(`传入的日期无效：${date}`);
  }
  
  // 现在可以安全调用Date的方法了
  let today = new Date();
  console.log(today.getTime());
  console.log(validDate.getTime());
  // 其余代码...
}

额外提醒 #

TypeScript的类型标注只是编译时的检查，运行时完全不保证类型。尤其是处理外部数据时，一定要做运行时的类型校验，避免这种“类型标注和实际值不符”的问题。

内容的提问来源于stack exchange，提问作者Prajat Padhi