Node.js 时区设置详解：为什么修改系统时区无效及正确配置方法-js教程-PHP中文网

Node.js 进程启动时即固化系统时区，运行时修改 process.env.TZ 或系统设置均不生效；必须在启动前通过环境变量（如 TZ=Asia/Baghdad）强制指定时区，并重启服务才能生效。

node.js 进程启动时即固化系统时区，运行时修改 `process.env.tz` 或系统设置均不生效；必须在启动前通过环境变量（如 `tz=asia/baghdad`）强制指定时区，并重启服务才能生效。

在你的代码中，new Date().getHours() 返回的是 Node.js 进程启动时所绑定的本地时区下的小时值，而非操作系统当前设置的时区。这就是为什么你手动更改了 Windows/macOS 的系统时区（如从 Baghdad 切换到 US/Eastern），Node.js 服务仍沿用旧时区——因为 Date 对象的行为由进程初始化阶段读取的 TZ 环境变量或 /etc/localtime 决定，不会动态响应系统设置变更。

✅ 正确做法：在启动服务前显式声明 TZ 环境变量
不要依赖系统时区，而是主动锁定时区。例如，为模拟 Baghdad 时间（UTC+3），启动命令应为：

TZ=Asia/Baghdad node server.js

或在 package.json 中配置：

{
  "scripts": {
    "start": "TZ=Asia/Baghdad node server.js"
  }
}

然后执行 npm start。

⚠️ 注意：以下操作完全无效（常见误区）：

JSON Toolkit

JSON文件多功能工具。支持格式化、验证、压缩、键排序及点记法路径查询。零依赖。

下载

process.env.TZ = 'Asia/Baghdad'（运行时赋值，V8 已缓存时区）
修改 Windows “日期和时间” 设置后不重启 Node 进程
在 Docker 容器中未设 -e TZ=Asia/Baghdad 却期望继承宿主机时区

? 验证是否生效：
在服务代码中添加验证逻辑：

console.log("时区确认：", new Date().toString()); // 应含 "AST"（Arabia Standard Time）而非 "GMT" 或 "UTC"
console.log("当前小时（Baghdad）：", new Date().getHours());

? 进阶建议（提升鲁棒性）：

统一架构时区标准：生产环境所有服务器、数据库、容器均设为 TZ=Asia/Baghdad（或 UTC），避免跨组件解析歧义；
避免字符串解析陷阱：new Date('2024-05-28') 在不同 TZ 下会被解释为「该时区当日 00:00」，导致时间戳偏移。推荐使用 ISO 8601 显式带时区格式，如 new Date('2024-05-28T00:00:00+03:00')；
前端时间判断？不推荐：你当前逻辑在服务端判断时段并返回对应 HTML，是合理设计；若需客户端动态切换主题，应通过 Intl.DateTimeFormat 指定时区获取本地时间：
```
const hour = new Intl.DateTimeFormat('en-US', { 
  timeZone: 'Asia/Baghdad', 
  hour: '2-digit', 
  hour12: false 
}).format(new Date());
```

? 总结：Node.js 的时区不是“操作系统快照”，而是“进程启动契约”。要确保时间逻辑可预测，唯一可靠路径是——启动前设 TZ，启动后勿改动，全程重启验证。