使用Utilities.formatDate()遇日期时间错误及时区匹配问题求助

1. 对齐时区的核心方案 #

Google Sheets和AppScript的时区显示名称存在差异，但底层对应的标准时区ID是统一的：

• 你需要的纽约时区（含夏令时自动切换：GMT-4/EST、GMT-5/EDT），AppScript中直接用标准ID America/New_York即可。这个ID对应Sheets里的**"Eastern Time (US & Canada)"**选项，虽然显示名称不同，但时区规则完全一致。
• 设置操作：
  • Sheets端：点击「文件」→「设置」→「时区」，选择「Eastern Time (US & Canada)」
  • AppScript端：要么在项目设置的时区下拉框选「GMT-4 Eastern Standard Time / New York」，要么打开appsscript.json清单文件，将timeZone字段设为"America/New_York"，两种方式等价。

2. 正确调用Utilities.formatDate() #

确认读取到的日期对象无误后，用对应时区和格式字符串生成目标结果：

// 假设date是从Sheets读取到的合法Date对象
const formattedDate = Utilities.formatDate(date, "America/New_York", "M/d/yyyy hh:mm a");
// 若要去掉分钟部分，修改格式字符串为：
// const formattedDate = Utilities.formatDate(date, "America/New_York", "M/d/yyyy hh a");

• 格式字符串说明：
  • M：无前导零的月份
  • d：无前导零的日期
  • yyyy：四位年份
  • hh：12小时制无前导零小时
  • mm：分钟（不需要则删除该段）
  • a：上午/下午标识（am/pm）

3. 常见错误排查 #

• 确保传入formatDate的第一个参数是Date类型对象，若读取结果是字符串，需先转换：new Date(sheetDateString)
• 避免直接用GMT-4作为时区参数，这种固定偏移量不会自动处理夏令时，会导致全年时间偏差，必须使用America/New_York这类带时区规则的ID。

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