如何在Google Cloud Functions中全局设置JavaScript运行时区？

要让Google Cloud Functions（GCF）的JavaScript运行时全局生效Europe/Berlin时区，核心是通过设置**环境变量TZ**来实现，Node.js运行时会自动读取这个变量并应用为全局默认时区。

具体配置方式 #

方式一：通过Cloud Functions控制台设置 #

1. 打开Google Cloud Console，进入Cloud Functions页面
2. 找到目标函数，进入函数详情页后点击顶部的"编辑"按钮
3. 下拉到"运行时、构建、连接和安全设置"区域，展开"环境变量"选项
4. 点击"添加变量"，输入键为TZ，值为Europe/Berlin
5. 保存并重新部署函数

方式二：通过gcloud命令行工具部署时设置 #

使用gcloud命令部署函数时，直接通过--set-env-vars参数指定时区环境变量：

gcloud functions deploy YOUR_FUNCTION_NAME \
  --runtime nodejs20 \  # 替换为你使用的Node.js版本
  --trigger-http \       # 根据你的函数触发器类型调整
  --set-env-vars TZ=Europe/Berlin

替换YOUR_FUNCTION_NAME为实际的函数名称，触发器参数根据你的函数类型修改（比如--trigger-event等）。

验证设置是否生效 #

部署完成后，可在函数代码中添加验证逻辑，调用后查看日志确认：

exports.yourFunction = (req, res) => {
  console.log(Intl.DateTimeFormat().resolvedOptions().timeZone); // 应输出Europe/Berlin
  console.log(new Date().getTimezoneOffset()); // 应输出-120（对应UTC+2时区）
  res.send('时区设置验证完成');
};

原理说明 #

Node.js运行时启动时会读取系统的TZ环境变量，将其作为全局默认时区。这个设置会全局生效：

• 影响new Date().getTimezoneOffset()返回的时区偏移值（Europe/Berlin夏令时为UTC+2，偏移值为-120分钟）
• 作为Intl.DateTimeFormat的默认时区参数
  所有运行在该函数实例中的代码都会遵循这个时区设置，无需对单个Date对象单独配置。

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