Google Apps Script：DateTimePicker显示UTC时区时间问题求助

你遇到的问题核心是：Gmail插件中的DateTimePicker未按预期使用用户本地时区解析Date.now()传入的时间戳，反而显示UTC时间。

原因 #

虽然官方文档说明未设置时区时组件会使用用户本地时区，但在Gmail插件的实际运行环境中，setValueInMsSinceEpoch传入的UTC时间戳可能未被自动转换为用户本地时区显示，需要显式指定时区偏移来修正。

解决办法 #

有两种可靠的方式解决这个问题：

1. 显式设置用户时区偏移

通过Date.getTimezoneOffset()获取当前用户本地时区与UTC的偏移分钟数，注意该方法返回值的符号与setTimeZoneOffsetInMins所需参数相反（例如UTC+8时区，getTimezoneOffset()返回-480，而setTimeZoneOffsetInMins需要传入480），代码示例：

const currentDate = new Date();
// 获取本地时区与UTC的偏移，取反后传入组件
const timeZoneOffset = -currentDate.getTimezoneOffset();

const dateTimePicker = CardService.newDateTimePicker()
  .setTitle("选择日期时间")
  .setValueInMsSinceEpoch(currentDate.getTime())
  .setTimeZoneOffsetInMins(timeZoneOffset);

2. 使用setDateTime方法替代setValueInMsSinceEpoch

直接传入Date对象给setDateTime方法，组件会自动处理时区转换，无需手动计算偏移：

const currentDate = new Date();

const dateTimePicker = CardService.newDateTimePicker()
  .setTitle("选择日期时间")
  .setDateTime(currentDate);

额外验证 #

如果上述方法仍未生效，可以通过CalendarApp.getDefaultCalendar().getTimeZone()获取用户日历设置的时区，再转换为分钟偏移后传入setTimeZoneOffsetInMins，确保与用户日历时区完全一致：

const calendarTimeZone = CalendarApp.getDefaultCalendar().getTimeZone();
// 将时区ID转换为分钟偏移
const timeZoneOffset = Utilities.formatDate(new Date(), calendarTimeZone, "Z")
  .match(/([+-]\d{2})(\d{2})/)
  .reduce((acc, val, idx) => idx === 1 ? parseInt(val) * 60 : acc + parseInt(val), 0);

const dateTimePicker = CardService.newDateTimePicker()
  .setTitle("选择日期时间")
  .setValueInMsSinceEpoch(Date.now())
  .setTimeZoneOffsetInMins(timeZoneOffset);

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