如何在Jest测试中多次覆盖process.env.TZ并使其生效？

Jest运行环境下，Node.js会在进程启动时缓存时区信息，后续修改process.env.TZ无法触发时区重新加载；同时Jest的沙箱机制对process.env的修改可能无法同步到底层系统配置，导致新创建的Date对象始终使用初始时区。以下是几种可行的解决方法：

方法1：使用later.js内置时区API（推荐） #

如果你使用later.js处理定时任务，无需依赖process.env.TZ，直接用later.js的内置方法切换时区即可绕过该问题：

const later = require('later');

// 设置目标时区
later.date.localTime().setTimezone('Europe/Amsterdam');
// 执行对应时区的crontab逻辑...

// 切换至另一个时区
later.date.localTime().setTimezone('Europe/Bucharest');
// 执行对应时区的crontab逻辑...

方法2：强制刷新Node.js时区缓存 #

若必须通过process.env.TZ切换时区，修改后可强制Node.js重新加载时区数据（类Unix系统适用，Windows需特殊处理）：

function updateTimezone(timeZone) {
  process.env.TZ = timeZone;
  // 类Unix系统发送SIGUSR2信号触发时区刷新
  if (process.platform !== 'win32') {
    process.emit('SIGUSR2');
  }
}

// 使用示例
updateTimezone('Europe/Amsterdam');
const offset1 = new Date().getTimezoneOffset();

updateTimezone('Europe/Bucharest');
const offset2 = new Date().getTimezoneOffset();

expect([offset1, offset2]).toEqual([-120, -180]);

方法3：使用时区模拟库 #

借助timezone-mock库直接模拟Date对象的时区行为，无需依赖系统时区配置：

1. 安装依赖：

npm install timezone-mock --save-dev

2. 测试中使用：

const timezoneMock = require('timezone-mock');

test('验证不同时区的偏移量', () => {
  timezoneMock.register('Europe/Amsterdam');
  const offsetAmsterdam = new Date().getTimezoneOffset();

  timezoneMock.register('Europe/Bucharest');
  const offsetBucharest = new Date().getTimezoneOffset();

  expect([offsetAmsterdam, offsetBucharest]).toEqual([-120, -180]);
});

方法4：单线程独立运行测试 #

使用--runInBand参数让Jest单线程运行目标测试文件，避免多测试的时区缓存干扰，确保修改process.env.TZ前未初始化Date实例：

jest --runInBand tz.test.js

内容的提问来源于stack exchange，提问作者Adjel van der Meer