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

关于Cloud Storage触发器的时区设置 #

Cloud Storage触发器本身不支持直接配置时区，触发器的触发逻辑基于Cloud Storage事件的UTC时间，且Cloud Functions运行环境默认使用UTC时区。但这完全不影响你处理特定时区的时间需求——所有时区相关逻辑都可以在函数代码内部实现。

存储阿根廷布宜诺斯艾利斯时区的时间戳并实现排序查询 #

核心逻辑说明 #

Date.now()返回的是UTC时间戳（从1970-01-01 UTC开始的毫秒数），这个数值是时区无关的，直接用它作为排序字段就能保证查询最新记录的准确性（数值越大时间越晚）。如果需要同时存储布宜诺斯艾利斯时区的可读时间，可以额外生成对应格式的字符串字段，但排序仍依赖UTC时间戳。

修改后的代码示例 #

import { onObjectFinalized } from "firebase-functions/v2/storage";
import { StorageObjectData } from "firebase-functions/v2/storage";
import * as firestore from "firebase-admin/firestore";

export const resizeImage = onObjectFinalized({
  region: 'southamerica-east1'
}, async (event: CloudEvent<StorageObjectData>) => {
  const fileBucket = event.data.bucket;
  const filePath = event.data.name as string;
  const contentType = event.data.contentType as string;
  
  try {
    /* 图片生成、优化、存储及原文件删除、URL写入Firestore的逻辑 */
  } catch(e: any) {
    // 获取UTC时间戳（用于排序）
    const utcTimestamp = Date.now();
    // 生成布宜诺斯艾利斯时区的可读时间字符串
    const buenosAiresTime = new Intl.DateTimeFormat('es-AR', {
      timeZone: 'America/Argentina/Buenos_Aires',
      year: 'numeric',
      month: '2-digit',
      day: '2-digit',
      hour: '2-digit',
      minute: '2-digit',
      second: '2-digit'
    }).format(new Date(utcTimestamp));

    const errorDocData = {
      timestamp: utcTimestamp, // UTC时间戳，用于排序查询
      localTimestamp: buenosAiresTime, // 布宜诺斯艾利斯时区的可读时间
      errorCode: e.errorCode || '',
      stack: e.stack || '',
      context: { filePath: event.data.name, bucket: event.data.bucket },
      message: e.message || '未知错误'
    };

    const colRef = firestore.getFirestore().collection(`Procesos/ProcesoOptimizarImagen/Errors`);
    await colRef.add(errorDocData);
  }
});

查询最新错误记录的方式 #

在Firestore中，直接对timestamp字段进行降序排序即可获取最新记录：

// 获取最新10条错误记录
const latestErrors = await firestore.getFirestore()
  .collection(`Procesos/ProcesoOptimizarImagen/Errors`)
  .orderBy('timestamp', 'desc')
  .limit(10)
  .get();

注意事项 #

• 不要直接用本地时间字符串排序：不同时区的时间字符串格式无法保证排序准确性，必须依赖UTC时间戳或Firestore的Timestamp对象。
• 如果偏好使用Firestore原生时间对象，可以替换Date.now()为firestore.Timestamp.now()，它本质也是基于UTC的，排序逻辑一致，且Firestore控制台会自动根据你的本地时区显示时间。

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