Google Apps Script获取公式单元格getDisplayValue空值及日期偏移问题

1. 为什么dispVal[11][0]返回null #

这里是基础的索引对应问题：getRange("AH1:AH")返回的数组从0开始计数，索引0对应AH1，索引1对应AH2，以此类推。你要取AH12的值需要用索引11，如果返回null，大概率是表格实际有效数据行数比你预想的少，或是读取数据时公式还未完成计算。
Apps Script完全支持读取公式生成的值，不存在无法识别公式范围的问题，不需要放弃当前方案直接处理原始数据集。如果存在公式计算延迟的情况，可以在拉取范围前加一行SpreadsheetApp.flush()，强制所有待执行的公式计算完成后再读取值。

2. 日期偏移的原因 #

这是时区不匹配导致的：

• 你贴出的日志里的日期用的是PDT时区（GMT-07:00）
• 你的Google Sheet表格设置的时区和脚本时区不一致，比如表格用的是中国标准时间（GMT+8:00），两个时区相差15小时，PDT的8月29日17点对应东八区的8月30日8点，显示出来就会差1天。

解决方法：

1. 打开表格，点击「文件」→「设置」→「常规」，查看表格时区
2. 打开Apps Script编辑器，点击「项目设置」，勾选「显示 appsscript.json 清单文件在编辑器中」，回到编辑器打开appsscript.json，把timeZone字段改成和表格一致的值，也可以直接在项目设置页选择相同的时区。

3. 动态获取AH列最后一个非空值的解决方案 #

不要硬编码索引，也不要直接拉取整列后取固定位置，用下面的代码过滤空值后取最后一个即可：

var SpreadsheetID = "myID";
var SheetName = "mySheet";

function gammaTilt() {
  var ss = SpreadsheetApp.openById(SpreadsheetID);
  var sheet = ss.getSheetByName(SheetName);
  // 强制刷新公式计算结果
  SpreadsheetApp.flush();
  // 拉取AH列所有值
  var column = sheet.getRange("AH1:AH");
  var dispVal = column.getDisplayValues();
  // 过滤掉空行，保留非空值
  var validValues = dispVal.filter(row => row[0] !== "" && row[0] !== null);
  // 取列标题
  var label = validValues[0][0];
  // 取最后一个有效数值
  var lastValue = validValues[validValues.length - 1][0];
  console.log(lastValue);
};

如果你的公式是ARRAYFORMULA生成的整列填充场景，可以额外加逻辑判断有效值规则，或是用getLastRow()结合公式所在范围优化拉取范围，降低不必要的性能消耗。

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