Google Sheets自定义扩展导入数据时Apps Script时区冲突处理方法

原有实现代码 #

activeSheetTimeZone = Session.getScriptTimeZone();

//将日期合并为对应开始、结束时间的展示格式
var range1 = sheet.getRange(2,shiftDayIndex,sheet.getLastRow()-1,1).getValues().map(date => Utilities.formatDate(date[0], activeSheetTimeZone,"MMM d"));
var range2 = sheet.getRange(2,shiftStartIndex,sheet.getLastRow()-1,1).getValues().map(date => Utilities.formatDate(date[0], activeSheetTimeZone,"h:mm a"));
var range3 = sheet.getRange(2,shiftEndIndex,sheet.getLastRow()-1,1).getValues().map(date => Utilities.formatDate(date[0], activeSheetTimeZone,"h:mm a"));

异常表现 #

• 导入CSV文件后，系统默认将导入的日期类数据判定为GMT+0时区时间，再按照项目设置的中部时区做时间偏移，最终格式化输出的日期、时间存在固定偏差
• 只有用户对导入完成的表格执行部分无明确规律的手动操作后，导入的日期数据才会同步到表格配置的中部时区，格式化结果才能恢复正常
• 初始排查中验证发现：Session.getScriptTimeZone() 与 SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTimeZone() 返回结果完全一致，排除了脚本时区与表格时区配置不匹配的猜想

问题根因 #

导入CSV流程写入的日期类数据，会临时处于幻影UTC状态：数据暂时不会绑定表格当前的时区配置，只有表格的时区配置校验流程被触发后，数据才会正式适配表格的时区规则。在数据绑定完成前执行的日期格式化逻辑，会因为时区基准错误产生固定偏移。

修复方案 #

不需要等待用户手动操作触发同步流程，仅需在脚本执行所有日期格式化逻辑前，主动调用表格的时区设置接口强制刷新配置即可：

1. 提前获取当前表格的配置时区
2. 直接调用 setSpreadsheetTimeZone(timezone) 方法，将获取到的时区值重新赋值给当前表格
3. 上述操作会强制触发表格内部的时区绑定校验流程，让刚导入的CSV日期数据立刻从幻影UTC状态同步到目标时区，后续执行的日期格式化逻辑就不会出现时区偏移。

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