Google Script：如何获取日期单元格的显示字符串值？

直接获取显示文本（最简便可靠的方法） #

Google Apps Script提供了getDisplayValue()方法，直接返回单元格当前显示的文本内容，完全绕开内部Date对象的时区偏差问题。

示例代码：

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(SHEET_NAME);
const displayDate = sheet.getRange('A3').getDisplayValue();
// displayDate 即为单元格显示的 "31.10.2022"

如果需要批量获取多个单元格的显示值，可使用getDisplayValues()：

const dateRange = sheet.getRange('A3:A10');
const displayDates = dateRange.getDisplayValues();
// 返回二维数组，每个元素对应单元格的显示文本

补充：修正脚本时区（若仍需使用Date对象） #

如果后续需要对日期做计算，不想通过字符串解析，可以修改脚本的运行时区，使其与Google Sheets表格的时区一致：

1. 打开脚本编辑器，点击菜单栏「项目设置」
2. 勾选「显示"appsscript.json"清单文件」
3. 在appsscript.json中找到timeZone字段，修改为表格对应的时区（比如欧洲时区可设为"Europe/London"或你所在的具体时区）
4. 保存后，getValue()获取的Date对象就会和表格显示的日期匹配，无需手动计算偏移

关于你之前DATE_SHIFT方案的问题 #

你遇到的小时数不稳定、时区切换（EDT/EST）、非整数分秒等问题，本质是Google Sheets的日期存储为UTC时间戳，而脚本默认用EST时区解析，加上夏令时规则变动导致偏移量不固定，手动计算偏移必然会出现异常，因此直接使用getDisplayValue()是最稳妥的解决方式。

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