Google Apps Script读取Sheet日期出现偏移及异常问题求助

问题代码 #

function new_date(){
  
  var tableau = SpreadsheetApp.openByUrl("URL_OK");
  var date_tabella = tableau.getRange("A2:A31");
  
  for(var i = 0; i<date_tabella.getValues().length; i++){

    Logger.log(date_tabella.getDisplayValues()[i]);
    Logger.log(new Date(date_tabella.getValues()[i]));

  }
}

现象 #

执行后日志显示：

• 通过getDisplayValues()获取的表格日期格式为[lun 01/04/2024]（意大利语格式，对应2024年4月1日周一）
• 经new Date(getValues()[i])转换后变为Sun Mar 31 18:00:00 GMT-04:00 2024，所有日期偏移1天，且首尾元素存在默认日期异常

问题解答 #

1. 首尾元素出现默认日期的原因 #

• 空单元格触发：你选中的范围是A2:A31，如果首尾单元格（A2或A31）是空值，getValues()会返回空内容，new Date(空值)会生成默认初始日期（通常是1970年1月1日左右的时间，具体依环境而定）。
• 范围超出实际数据：若Sheet中A2到A31的首尾行没有实际日期数据，就会出现这种异常。

2. 所有日期偏移1天的原因 #

这是时区差异+重复转换导致的：

• Google Sheet以UTC时区存储日期，而你的脚本运行环境时区是GMT-04:00（比UTC晚4小时）。当你用new Date()再次包装getValues()返回的Date对象时，会把UTC基准的日期转换为本地时区，导致显示的日期看起来少了一天（比如UTC的4月1日00:00，转换为GMT-04:00就是3月31日18:00）。
• 实际上getValues()返回的已经是正确的Date对象，重复用new Date()转换属于多余操作，反而放大了时区差异的影响。

正确解决方案 #

直接使用getValues()返回的Date对象，无需二次转换，同时过滤空单元格：

function new_date(){
  var tableau = SpreadsheetApp.openByUrl("URL_OK");
  var dateValues = tableau.getRange("A2:A31").getValues();
  
  for(var i = 0; i < dateValues.length; i++){
    var cellValue = dateValues[i][0]; // getValues返回二维数组，需取索引0的元素
    if(cellValue instanceof Date){ // 仅处理有效日期单元格
      // 按表格显示格式输出日期
      var displayDate = Utilities.formatDate(cellValue, Session.getScriptTimeZone(), "EEE dd/MM/yyyy");
      Logger.log("表格显示日期：" + displayDate);
      Logger.log("正确的Date对象：" + cellValue);
    } else {
      Logger.log("第" + (i+2) + "行无有效日期"); // 对应A2开始的行号
    }
  }
}

关键说明 #

• getValues()返回的结果本身就是Date对象，直接使用即可，不需要再用new Date()包装。
• Utilities.formatDate()可以指定时区和格式，让输出日期和表格显示完全一致。
• 加入空值判断，过滤无效单元格，避免默认日期异常。

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