寻求无需修改系统时间的NodeJS应用过往时间模拟方案

针对你的场景，推荐以下几个轻量可靠的时间模拟库，它们能在应用进程内部拦截原生Date和moment的时间获取逻辑，完全不会影响系统真实时间和第三方服务的证书校验：

1. timekeeper #

最适合全局时间冻结的工具，对moment天然兼容（因为moment底层依赖原生Date）。

安装与使用 #

npm install timekeeper --save-dev

在应用入口文件最顶部初始化：

const tk = require('timekeeper');

// 模拟2023年10月1日0点（UTC时间）
const targetDate = new Date('2023-10-01T00:00:00Z');
tk.freeze(targetDate);

// 后续整个应用内的Date、moment调用都会返回这个模拟时间
console.log(new Date()); // 输出 2023-10-01T00:00:00.000Z
console.log(require('moment')().format('YYYY-MM-DD')); // 输出 2023-10-01

// 调试完成后恢复真实时间
// tk.reset();

2. sinon（Fake Timers） #

如果你的项目已经在用sinon做测试，可以直接用它的内置时间模拟功能，支持时间冻结和步进模拟。

安装与使用 #

npm install sinon --save-dev

初始化示例：

const sinon = require('sinon');

// 用时间戳设置模拟时间（2022年5月15日12点UTC）
const mockTimestamp = new Date('2022-05-15T12:00:00Z').getTime();
const clock = sinon.useFakeTimers(mockTimestamp);

// 测试或调试逻辑
console.log(moment().hour()); // 输出 12

// 恢复真实时间
// clock.restore();

3. mockdate #

专注于Date对象模拟的轻量库，API简洁，支持多种时间格式输入。

安装与使用 #

npm install mockdate --save-dev

初始化示例：

const MockDate = require('mockdate');

// 直接传入日期字符串设置模拟时间
MockDate.set('2021-01-01');

console.log(new Date().getFullYear()); // 输出 2021
console.log(moment().month() + 1); // 输出 1（moment月份从0开始）

// 恢复真实时间
// MockDate.reset();

关键注意事项 #

• 所有这些库仅在当前Node.js进程内生效，不会修改系统时间，因此MongoDB、Salesforce等第三方服务的证书校验会正常使用系统真实时间，完全避免证书错误问题。
• 建议只在调试、测试场景使用，绝对不要在生产环境启用。
• 初始化一定要放在应用入口的最顶部，确保所有依赖Date或moment的模块加载前就完成时间模拟。

内容的提问来源于stack exchange，提问作者Rahul Bhooteshwar