Docker容器内如何让NodeJS遵循系统时区（无需外部库）

你的Docker容器已通过TZ环境变量设置了正确时区（系统date命令输出正常），但NodeJS执行new Date()时仍输出UTC格式时间，可通过以下无外部依赖的方法解决：

方法1：完善Dockerfile的时区配置 #

Alpine镜像默认未正确设置系统时区文件，需手动链接时区数据，修改Dockerfile如下：

FROM node:20-alpine

WORKDIR /app

RUN apk add --no-cache chromium openssl tzdata \
    # 复制对应时区文件到系统默认时区路径
    && cp /usr/share/zoneinfo/America/Sao_Paulo /etc/localtime \
    # 写入时区信息到配置文件
    && echo "America/Sao_Paulo" > /etc/timezone

ENV TZ=America/Sao_Paulo

# ... rest of Dockerfile

重新构建镜像后，NodeJS会自动识别系统时区。

方法2：启动Node时显式指定时区（临时方案） #

若不想修改Dockerfile，可在启动Node应用时直接传递TZ环境变量：

TZ=America/Sao_Paulo node your-app.js

注意：关于new Date()的输出格式 #

NodeJS中直接打印new Date()时，默认调用toISOString()方法，会输出UTC格式的ISO字符串，这属于方法特性而非时区未生效。可通过以下命令验证时区是否生效：

node -e "console.log(new Date().toString())"
# 输出示例：Mon May 19 2025 11:21:37 GMT-0300 (Brasilia Standard Time)

调用toString()、toLocaleString()等方法会显示对应时区的时间格式。

内容的提问来源于stack exchange，提问作者Timóteo Stifft