如何通过Google Sheets API (v4) 将单元格格式设置为Duration类型

解决方案 #

Google Sheets API v4 公开的NumberFormat枚举中确实没有DURATION选项，你可以通过指定type为TIME+匹配Duration规则的格式pattern的方式，实现和UI端设置Duration完全一致的效果。

配置示例

"cell": {
  "userEnteredFormat": {
    "numberFormat": {
      "type": "TIME",
      "pattern": "[h]:mm:ss"
    }
  }
},
"fields": "userEnteredFormat.numberFormat"

核心要点是pattern中用[h]、[m]这类带中括号的时间单位标识，代表按累计时长统计，不会出现普通TIME类型超过24小时自动转日期的问题。

常用Duration pattern参考

• 累计小时+分钟+秒：[h]:mm:ss
• 累计小时+分钟：[h]:mm
• 累计分钟+秒：[m]:ss
• 带毫秒精度的时长：[h]:mm:ss.000

按上述规则配置后，单元格在UI界面会被自动识别为「Duration」格式，计算规则和手动设置的完全一致。

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