Google Apps Script中如何正确获取DateTimePicker的DateTime值

你遇到的问题根源是setTimeZoneOffsetInMins仅支持固定偏移值，而EST/EDT是北美东部时区（IANA时区标识符：America/New_York）的两种时令状态，无需手动判断当前属于哪个时令，可通过以下两种方案解决：

方案1：直接指定IANA时区（优先推荐） #

当前Google Apps Script的Card Service原生支持DateTimePicker直接传入IANA时区标识符，组件会自动适配夏令时规则，动态切换EST/EDT偏移：

const dateTimePicker = CardService.newDateTimePicker()
  .setFieldName("user_selected_time")
  .setTitle("选择日期与时间")
  // 直接设置为北美东部时区，自动处理夏令时切换
  .setTimeZone("America/New_York")
  // 可选：在组件中展示当前时区缩写（EST/EDT）
  .setTimeZoneDisplay(CardService.TimeZoneDisplay.SHORT)

如果需要适配当前登录用户的本地时区，可直接调用Session.getActiveUserTimeZone()获取用户的IANA时区标识符传入即可。

方案2：动态计算时间点偏移（兼容旧接口场景） #

如果必须使用setTimeZoneOffsetInMins方法，可通过GAS内置的时区处理能力，动态计算目标时间点对应的偏移值，再传入组件：

/**
 * 计算指定时间在目标时区的偏移分钟数
 * @param {Date} targetDate 待计算的目标时间
 * @param {string} timeZoneId IANA时区标识符
 * @return {number} 时区偏移分钟数
 */
function calcTimeZoneOffsetMins(targetDate, timeZoneId) {
  const utcMillis = Date.parse(targetDate.toLocaleString("en-US", { timeZone: "UTC" }));
  const tzMillis = Date.parse(targetDate.toLocaleString("en-US", { timeZone: timeZoneId }));
  return (utcMillis - tzMillis) / 60000;
}

// 调用示例
const targetDate = new Date(); // 可替换为用户预选的时间
// 6月夏令时时段返回240（对应EDT UTC-4），1月冬令时时段返回300（对应EST UTC-5）
const offsetMins = calcTimeZoneOffsetMins(targetDate, "America/New_York");

const dateTimePicker = CardService.newDateTimePicker()
  .setFieldName("user_selected_time")
  .setTitle("选择日期与时间")
  .setTimeZoneOffsetInMins(offsetMins)

注意事项 #

• 不要手动维护夏令时切换日期，IANA时区数据库会定期更新全球各地的夏令时规则，GAS内置的时区处理逻辑会自动同步更新，无需手动调整。
• 其他时区同理，只需替换为对应IANA标识符即可，无需单独处理夏令时逻辑。

内容的提问来源于stack exchange，提问作者Chris B.