GAS中Google Sheet的searchData函数因日期数据报错求助

一、修复“Uncaught TypeError: Cannot read properties of null (reading 'length')”报错 #

这个错误核心是代码中存在未校验的null值就直接调用length属性，以下是针对性修复：

• 必须校验工作表是否存在：调用getSheetByName后判断返回值，避免后续操作基于null执行
• 校验数据范围有效性：确认源表有数据行后再读取列数据
• 正则匹配前跳过空单元格，避免空值转换异常

示例修复后的searchData函数：

function searchData(keyword) {
  const sourceSS = SpreadsheetApp.getActiveSpreadsheet();
  const sourceSheet = sourceSS.getSheetByName('源表');
  // 校验工作表是否存在
  if (!sourceSheet) return [];
  const lastRow = sourceSheet.getLastRow();
  // 校验是否有数据行（假设表头在第1行）
  if (lastRow < 2) return [];
  // 读取第一列数据（从第2行开始）
  const firstColumn = sourceSheet.getRange(2, 1, lastRow - 1, 1).getValues();
  const regex = new RegExp(keyword, 'i');
  const matchedRowIndexes = [];

  firstColumn.forEach((cell, index) => {
    const cellValue = cell[0];
    // 跳过空单元格
    if (cellValue === '') return;
    // 统一转换为字符串，兼容日期、数字、字符串类型
    const valueStr = cellValue instanceof Date 
      ? cellValue.toLocaleDateString() 
      : String(cellValue);
    // 正则匹配
    if (regex.test(valueStr)) {
      // 转换为实际行号（第2行对应index=0，所以+2）
      matchedRowIndexes.push(index + 2);
    }
  });
  return matchedRowIndexes;
}

二、解决日期数据行无法显示的问题 #

Google Apps Script读取日期单元格会返回Date对象，直接处理会导致匹配失败或前端显示异常，需统一转换为可读字符串：

1. 在searchData函数中，将Date对象转换为本地化日期字符串（如toLocaleDateString()）后再进行正则匹配
2. 获取整行数据展示时，同样将Date对象转换为前端可识别的格式，示例函数：

function getRowContent(rowIndex) {
  const sourceSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('源表');
  if (!sourceSheet || rowIndex < 1 || rowIndex > sourceSheet.getLastRow()) return null;
  // 读取整行数据
  const rowData = sourceSheet.getRange(rowIndex, 1, 1, sourceSheet.getLastColumn()).getValues()[0];
  // 处理每行中的日期和空值
  return rowData.map(item => {
    if (item instanceof Date) {
      // 自定义日期格式，比如YYYY-MM-DD
      return Utilities.formatDate(item, Session.getScriptTimeZone(), 'YYYY-MM-DD');
    }
    // 空值替换为占位符，避免前端显示空内容
    return item === '' ? '-' : item;
  });
}

三、移动行的注意事项 #

找到目标行后，移动时需保证数据完整性，同时避免行号偏移：

• 复制行时使用PASTE_VALUES_AND_FORMATTING保留格式
• 批量移动时需从下往上删除行，防止删除后上方行号偏移
  示例移动函数：

function moveMatchedRow(rowIndex) {
  const sourceSS = SpreadsheetApp.getActiveSpreadsheet();
  const sourceSheet = sourceSS.getSheetByName('源表');
  const targetSheet = sourceSS.getSheetByName('目标表');
  
  if (!sourceSheet || !targetSheet || rowIndex < 1 || rowIndex > sourceSheet.getLastRow()) return;
  
  // 复制到目标表末尾
  sourceSheet.getRange(rowIndex, 1, 1, sourceSheet.getLastColumn()).copyTo(
    targetSheet.getRange(targetSheet.getLastRow() + 1, 1),
    SpreadsheetApp.CopyPasteType.PASTE_VALUES_AND_FORMATTING
  );
  // 删除源表中的行
  sourceSheet.deleteRow(rowIndex);
}

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