如何使用Cloud Functions基于起止时间字段计算任务/事件时长？

前置约定 #

先统一前端上传的四个字段的格式，避免解析出错：

• 开始日期/结束日期格式统一为 YYYY-MM-DD（例如2024-05-20）
• 开始时间/结束时间格式统一为 HH:mm:ss（例如14:30:00）
• 四个字段均为非空必填，若任务未结束可暂时不传结束相关字段，待结束后再触发计算

核心实现逻辑 #

1. 从触发事件的文档中读取四个时间字段，做空值校验
2. 将日期和时间拼接为标准ISO时间格式，转换为Date类型对象
3. 计算两个Date对象的时间差，转换为需要的时长单位（毫秒、秒、分钟、小时、天都可按需调整）
4. 将计算得到的时长写入目标存储位置

完整修改后的Cloud Functions代码 #

import * as admin from 'firebase-admin'
import * as functions from 'firebase-functions'

admin.initializeApp()

export const updateCharts = 
functions.firestore.document('users/{UserId}/count/{uid}')
.onWrite(async(change, _) => await updateStats(change))

async function updateStats (change: functions.Change<functions.firestore.DocumentSnapshot>) {
  // 过滤删除操作，删除状态不需要计算时长
  if (!change.after.exists) return
  const docData = change.after.data()
  const chartRating = change.after.ref.parent

  let title = (await chartRating.where('Title', '==', 'Game').get()).size

  // ========== 时长计算逻辑开始 ==========
  let durationMinutes = 0
  // 字段名可根据你实际存储的字段名调整
  const { startDate, startTime, endDate, endTime } = docData || {}
  // 仅四个字段都存在时才触发计算
  if (startDate && startTime && endDate && endTime) {
    // 拼接为标准时间格式
    const startDateTime = new Date(`${startDate}T${startTime}`)
    const endDateTime = new Date(`${endDate}T${endTime}`)
    // 校验时间合法性
    if (isNaN(startDateTime.getTime()) || isNaN(endDateTime.getTime())) {
      console.error('时间格式错误，请检查传入的日期时间字段')
    } else {
      // 示例计算分钟级时长，按需调整单位即可：
      // 秒：diffMs / 1000；小时：diffMs / (1000*60*60)；天：diffMs / (1000*60*60*24)
      const diffMs = endDateTime.getTime() - startDateTime.getTime()
      // 兼容结束时间早于开始时间的异常场景，取绝对值
      durationMinutes = Math.round(Math.abs(diffMs) / (1000 * 60))
    }
  }
  // ========== 时长计算逻辑结束 ==========

  const restaurantRef = chartRating.parent!

  console.log(`${restaurantRef.path} now has ${title}, duration: ${durationMinutes}分钟`)
  await restaurantRef.update({
    Title: title,
    // 写入时长字段，字段名可自定义
    duration: durationMinutes
  })
}

注意事项 #

• 时区问题：如果业务跨时区，建议前端采集时间时统一转换为UTC格式再上传，避免云函数时区和客户端时区不一致导致计算偏差
• 分段任务兼容：如果任务支持暂停续做，可以新增分段时间存储字段，每次暂停时累加当前段时长到总时长即可
• 状态判断：如果有未完成的任务，可以新增isCompleted字段标记状态，仅任务标记为已完成时触发全量时长计算

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