如何将Google Apps Script日历检索脚本中的setValue循环改为批量数组以提升运行效率？

解决方案 #

Google Apps Script的性能瓶颈大多来自频繁调用Google服务（比如getRange、setValue），所以核心优化思路是先把所有要写入的数据整理成二维数组，再用一次setValues()批量写入，同时格式设置也批量处理，减少服务交互次数。

修改后的完整代码

function getCalendarEvents() { 
  var ss = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Data"); 
  var cal = CalendarApp.getCalendarById("email@domain.nl"); 
  var eind = new Date(); 
  eind.setDate(eind.getDate() + 1); 
  var events = cal.getEvents(new Date("1/1/2022"), eind); 
  var lr = ss.getLastRow(); 

  // 清空原有数据
  ss.getRange(3, 1, lr, 14).clearContent(); 

  // 初始化二维数组，用来存放所有要写入工作表的行数据
  var outputData = [];

  // 遍历日历事件，构建每行的数据
  events.forEach(function(event) { 
    // 获取当前事件的各项数据
    var startTime = event.getStartTime(); 
    var eventTitle = event.getTitle(); 
    var endTime = event.getEndTime(); 
    var eventDesc = event.getDescription(); 
    var isRecurring = event.isRecurringEvent(); 
    var createdDate = event.getDateCreated(); 
    var lastUpdated = event.getLastUpdated(); 
    var creators = event.getCreators(); 

    // 构建一行数据：数组元素顺序要和工作表的列一一对应
    // 原代码从列2开始写入，所以列1留空；未用到的列也用空字符串填充
    var rowData = [
      "",          // 列1：留空
      startTime,   // 列2：事件开始时间
      "",          // 列3：留空
      "",          // 列4：留空
      endTime,     // 列5：事件结束时间
      "",          // 列6：留空
      "",          // 列7：留空
      "",          // 列8：留空
      eventTitle,  // 列9：事件标题
      eventDesc,   // 列10：事件描述
      createdDate, // 列11：事件创建日期
      lastUpdated, // 列12：事件最后更新时间
      isRecurring, // 列13：是否为重复事件
      creators     // 列14：事件创建者
    ];

    // 将当前行数据加入总数组
    outputData.push(rowData);
  });

  // 只有当有数据时才执行写入操作
  if (outputData.length > 0) {
    // 批量写入所有数据：范围从第3行第1列开始，行数是数组长度，列数是每行的元素数
    ss.getRange(3, 1, outputData.length, outputData[0].length).setValues(outputData);

    // 批量设置日期格式，替代原来逐个单元格设置的方式
    ss.getRange(3, 2, outputData.length).setNumberFormat("ddd d-m-yyyy");
    ss.getRange(3, 5, outputData.length).setNumberFormat("h:mm");
  }
}

关键优化点说明

1. 二维数组的构建：每个子数组对应工作表的一行，元素顺序必须和工作表列的位置完全匹配，未用到的列用空字符串填充，保证数组结构和工作表范围一致。
2. 批量写入：setValues()只调用一次，相比原循环里多次调用setValue，能大幅减少Google服务的调用次数，提升运行速度。
3. 批量格式设置：针对整列的范围一次性设置格式，而不是逐个单元格操作，进一步优化性能。
4. 关于之前的map失败原因：你注释里的map写法错误，因为events里的每一项是CalendarEvent对象，不是数组，不能用r[0]来获取数据，必须调用对象的方法（比如getStartTime()）来提取信息。

内容的提问来源于stack exchange，提问作者Marc van Maastricht