将多次setValue调用合并为单次setValues调用优化Google Apps Script效率

核心原因是多次调用setValue会频繁发起与Google Sheets的交互请求，累积后容易触发超时限制。setValues通过单次交互完成批量写入，能大幅提升执行效率。以下是具体实现方案：

步骤说明 #

1. 构建二维数组（setValues要求的格式，即使单行也需嵌套），数组长度对应目标单元格覆盖的列范围。
2. 空列（无需赋值的单元格，如C5）用空字符串填充，避免覆盖原有内容。
3. 数组索引与列位置对应：A列为索引0，B列为1，D列为3，以此类推到J列为9。
4. 选择与数组匹配的单元格范围，执行单次setValues写入。

示例代码 #

function setTimesBatch() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Sheet1");
  const baseTime = new Date(); // 替换为你的指定基准时间

  // 构建单行数组，对应第5行A-J列（共10列）
  const rowData = new Array(10).fill("");

  // 为目标单元格赋值（索引对应列：B=1，D=3，E=4...J=9）
  rowData[1] = new Date(baseTime.getTime() + 3600000);   // B5：基准时间+1小时
  rowData[3] = new Date(baseTime.getTime() + 7200000);   // D5：基准时间+2小时
  rowData[4] = new Date(baseTime.getTime() + 10800000);  // E5：基准时间+3小时
  rowData[5] = new Date(baseTime.getTime() + 14400000);  // F5：基准时间+4小时
  rowData[6] = new Date(baseTime.getTime() + 18000000);  // G5：基准时间+5小时
  rowData[7] = new Date(baseTime.getTime() + 21600000);  // H5：基准时间+6小时
  rowData[8] = new Date(baseTime.getTime() + 25200000);  // I5：基准时间+7小时
  rowData[9] = new Date(baseTime.getTime() + 28800000);  // J5：基准时间+8小时

  // 批量写入第5行A-J列
  sheet.getRange(5, 1, 1, 10).setValues([rowData]);
}

可选优化（仅覆盖目标列） #

如果不想涉及A列和C列，可缩小写入范围到B5-J5，对应数组长度为9（B到J共9列）：

function setTimesBatchNarrow() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Sheet1");
  const baseTime = new Date();

  // 数组对应B5-J5（索引0=B，1=C，2=D...8=J）
  const rowData = new Array(9).fill("");
  rowData[0] = new Date(baseTime.getTime() + 3600000);   // B5
  rowData[2] = new Date(baseTime.getTime() + 7200000);   // D5
  rowData[3] = new Date(baseTime.getTime() + 10800000);  // E5
  // ... 后续J5对应索引8

  sheet.getRange("B5:J5").setValues([rowData]);
}

注意事项 #

• 确保赋值为合法Date对象，Google Sheets会自动识别为时间格式。
• 批量写入不会改变单元格原有格式，与setValue行为一致。
• 此方法将API调用次数从N次减少到1次，能有效避免30秒超时限制。

内容的提问来源于stack exchange，提问作者Dan Y.