Google Apps Script 表格日期与Drive文件创建日期比对失效问题

问题现象 #

开发绑定Google Sheets的Apps Script脚本时，需要实现每次运行仅拉取Google Drive指定文件夹内新增文件的逻辑：表格D列存储已录入文件的创建日期，因每次运行后会对所有记录按日期排序，因此取D列最后一个非空值作为已记录的最新文件创建时间，仅拉取创建时间晚于该值的文件写入表格。
代码运行时日期比对逻辑 new Date(varTime).getTime() >= new Date(lastTimeCreated).getTime() 失效，无法正确筛选新增文件，已确认文件侧的时间变量可正常解析，尝试用Date.parse()处理后问题仍存在。
涉及的电子表格样式如下：

问题根因 #

• 核心问题是日期类型转换逻辑错误：从Google Sheets单元格读取的日期值本身就是标准JavaScript Date对象，并非字符串，强行传入new Date()做二次解析时，会因Apps Script的对象序列化规则差异，解析出 Invalid Date，最终比对结果为NaN，逻辑判断完全失效。
• 原有代码存在两个隐性bug：
  • 遍历Drive文件时调用toLocaleString()将文件创建时间转为本地化字符串，该字符串格式随脚本运行时区、语言环境变化，本身就存在解析不稳定的问题
  • 末尾排序逻辑中取a[3]/b[3]做比对，但存入dataRows的数组仅包含1个元素，索引3无有效值，排序逻辑实际未生效

修复方案 #

全程使用 时间戳（毫秒级数值） 做日期比对，完全避免字符串解析带来的格式兼容问题，同时修正原有逻辑的隐性bug：

1. 读取表格D列最后一条记录时，直接从原生Date对象中提取时间戳作为比对基准，不做任何字符串转换
2. 获取Drive文件创建时间时，直接调用原生Date对象的getTime()方法取时间戳，不转本地化字符串
3. 修正排序逻辑的数组索引，和写入行的字段位置对应
4. D列无有效记录时，直接构造Date对象取初始时间戳，不使用字符串格式的日期赋值

修复后完整代码 #

function syncNewDriveFiles() {
  const activeSheet = SpreadsheetApp.getActiveSheet();
  const targetFolder = DriveApp.getFolderById('1gsXZWKSPxAsFiyuaMMNTkg6n_4p9HOeU');
  const fileIterator = targetFolder.getFiles();

  // 提取D列所有有效日期值，取最后一条的时间戳作为上次同步截止点
  const dColumnValues = activeSheet.getRange('D:D')
    .getValues()
    .flat()
    .filter(cellVal => cellVal instanceof Date);
  
  let lastSyncTimestamp = 0;
  // 无历史记录时，初始截止时间设为2020-10-01 12:00:00
  if (dColumnValues.length === 0) {
    lastSyncTimestamp = new Date(2020, 9, 1, 12, 0, 0).getTime();
  } else {
    lastSyncTimestamp = dColumnValues.pop().getTime();
  }

  const newFileRows = [];
  // 补全原有代码中缺失的变量定义，替换为实际业务逻辑
  const allowedCheckValue = activeSheet.getName();

  while (fileIterator.hasNext()) {
    const currentFile = fileIterator.next();
    const createTime = currentFile.getDateCreated();
    const createTimestamp = createTime.getTime();
    // 替换为实际的所有者判断逻辑
    const fileOwner = currentFile.getOwner().getEmail();

    // 直接用数值型时间戳比对，无解析风险
    if (createTimestamp > lastSyncTimestamp && fileOwner.includes(allowedCheckValue)) {
      // 按实际业务需要调整写入字段，示例字段：文件名、文件链接、所有者、创建时间
      newFileRows.push([
        currentFile.getName(),
        currentFile.getUrl(),
        fileOwner,
        createTime
      ]);
    }
  }

  // 修正排序索引：创建时间在数组第4位（索引从0开始为3），和push的字段位置对应
  const sortedNewRows = newFileRows.sort((rowA, rowB) => rowA[3].getTime() - rowB[3].getTime());

  // 将排序后的新记录追加到表格末尾
  if (sortedNewRows.length > 0) {
    const appendStartRow = activeSheet.getLastRow() + 1;
    activeSheet.getRange(appendStartRow, 1, sortedNewRows.length, sortedNewRows[0].length)
      .setValues(sortedNewRows);
  }
}

优化说明 #

• 所有日期比对均使用数值型时间戳，不存在字符串解析的格式兼容问题，逻辑稳定性100%
• 写入表格的日期为原生Date对象，会自动适配表格中已设置的日期显示格式，无需手动转字符串
• 移除了无意义的continue分支和计数器变量，用数组push方法追加元素更简洁
• 补全了原代码中未声明的变量，避免隐式全局变量带来的异常

内容的提问来源于stack exchange，提问作者Rothman Mariño