如何为第二代Cloud Functions的Cloud Storage触发器设置时区？

• 结论：第二代Cloud Functions的Cloud Storage触发器不支持直接配置自定义时区，函数运行环境默认使用UTC时区，Storage事件的时间戳也是基于UTC生成的。

• 关于FieldValue.serverTimestamp()：这个方法生成的是Firestore服务器的UTC时间戳，和Cloud Functions的运行时区无关——它由Firestore服务端直接生成，不受函数环境时区影响，所以即使能修改函数时区，也不会改变这个方法返回的时间。

• 解决方案：如果需要基于特定时区处理时间，只能在函数内部手动转换：

  1. 先获取UTC时间（比如Storage事件的event.time，或者serverTimestamp()返回的时间）
  2. 通过JavaScript原生API或第三方库将UTC时间转换为目标时区的时间

举个JavaScript的实践例子，把UTC时间转换为北京时间：

exports.handleStorageUpload = onObjectFinalized(async (event) => {
  // 获取事件的UTC时间
  const utcTime = new Date(event.time);
  
  // 转换为北京时间（Asia/Shanghai）
  const formattedBeijingTime = new Intl.DateTimeFormat('zh-CN', {
    timeZone: 'Asia/Shanghai',
    year: 'numeric',
    month: '2-digit',
    day: '2-digit',
    hour: '2-digit',
    minute: '2-digit',
    second: '2-digit'
  }).format(utcTime);
  
  console.log('上传事件时间（北京时间）:', formattedBeijingTime);
  
  // 如果要存储特定时区的时间到Firestore，不要用serverTimestamp，手动构建对应时间
  // 注意：直接加减小时可能忽略夏令时，推荐用时区库处理更准确
  const beijingDate = new Date(utcTime.toLocaleString('en-US', { timeZone: 'Asia/Shanghai' }));
  await db.collection('uploads').add({
    uploadTime: beijingDate,
    fileName: event.name
  });
});

另外补充：如果是定时触发器（而非Storage事件触发器），第二代Cloud Functions支持在配置时指定时区，但Storage这类事件驱动触发器没有这个配置项。

内容的提问来源于stack exchange，提问作者Lucas David Ferrero