Google Cloud Functions中getTimezoneOffset()始终返回0的问题排查

原因 #

Google Cloud Functions的运行环境默认使用UTC时区，无论部署到哪个地理区域，new Date().getTimezoneOffset()都会返回0（UTC与自身的偏移量为0），这是环境默认配置导致的，并非你的代码存在错误。

解决方法 #

方法1：设置环境变量（推荐） #

在Cloud Function的配置页面中添加TZ环境变量，值设置为部署区域对应的时区标识符：

• us-east4（弗吉尼亚州阿什本）对应的时区标识符为America/New_York

设置完成后重新部署函数，此时getTimezoneOffset()会返回对应时区与UTC的偏移量（比如纽约时区非夏令时为-300，夏令时为-240）。

方法2：代码中手动处理时区 #

如果不想修改环境变量，可以在代码里手动处理时区逻辑，比如用Intl.DateTimeFormat获取时区信息，或借助第三方库（如moment-timezone）处理转换。示例代码：

// 获取当前运行环境的时区
const currentTimeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
console.log("当前时区:", currentTimeZone);

// 计算指定时区的偏移量（以纽约时区为例）
const nyDateTimeStr = new Date().toLocaleString("en-US", { timeZone: "America/New_York" });
const nyTimezoneOffset = new Date(nyDateTimeStr).getTimezoneOffset();
console.log("纽约时区偏移量:", nyTimezoneOffset);

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