Google Sheets日程脚本报错：CalendarApp.createEvent参数不匹配求助

问题说明 #

制作车间服务日程的Google Sheet时，按教程操作后出现报错：

Exception: The parameters (String,String,null,(class)) don't match the method signature for CalendarApp.Calendar.createEvent

已将开始/结束时间单元格格式设为「日期时间」，清空无关单元格后问题仍存在，怀疑单元格范围设置错误。

相关脚本代码 #

let calendarId = 'westsideservicing@gmail.com'; // 替换为你的日历ID

// 打开Sheet时添加自定义菜单
function onOpen() {
    let ui = SpreadsheetApp.getUi();
    ui.createMenu("Chur Bro").addItem("Update Calendar", "updateCalendar").addToUi();
}

// 主函数：遍历数据，执行增删改操作
function updateCalendar() {
    let ss = SpreadsheetApp.getActiveSpreadsheet();
    let sheet = ss.getSheetByName("Service Register");
    let events = sheet.getRange(9,13,sheet.getLastRow()-1,24).getValues();

    for (i = 0; i < events.length; i++) {
        let event = events[i];
        let returnedData;

        if (event[0] != '') {
            switch (event[0]) {
                case 'Add':
                    returnedData = addEvent(event)
                    break;
                case 'Update':
                    returnedData = updateEvent(event);
                    break;
                case 'Delete':
                    returnedData = deleteEvent(event);
                    break;
            }
            sheet.getRange(i + 9, 21, 9, ).setValues([returnedData]);
        }
    }
    sheet.getRange(9, 13, sheet.getLastRow()-1, 13).clearContent();
}

// 添加日历事件
function addEvent(event) {
  let title = event[17];
  let description = event[18];
  let location = event[19];
  let emails = event[20];
  let startTime = event[23]
  let endTime = event[24]
  let options = {};

  if (description != '') { options['description'] = description; }
  if (location != '') { options['location'] = location; }
  if (emails != '') { options['guests'] = emails; }

  let calendar = CalendarApp.getCalendarById(calendarId);
  let id = calendar.createEvent(title, startTime, endTime, options).getId();
  return ["Added", id];
}

// 更新日历事件
function updateEvent(event) {
    let title = event[17];
    let description = event[18];
    let location = event[19];
    let emails = event[20];
    let eventId = event[22];
    let startTime = event[23];
    let endTime = event[24];

    let calendar = CalendarApp.getCalendarById(calendarId);
    let thisEvent = calendar.getEventById(eventId);
    thisEvent.setTime(startTime, endTime)
        .setTitle(title)
        .setDescription(description)
        .setLocation(location);

    if (emails != '') {
        emails = emails.split(",");
        emails.forEach(x => thisEvent.addGuest(x));
    }
    return ["Modified", eventId];
}

// 删除日历事件
function deleteEvent(event) {
    let eventId = event[22];
    let calendar = CalendarApp.getCalendarById(calendarId);
    let thisEvent = calendar.getEventById(eventId);
    thisEvent.deleteEvent();
    return ['Deleted', ''];
}

Google Sheet截图 #

核心问题与修复方案 #

1. 数组索引越界（报错直接原因） #

createEvent要求开始/结束时间必须是Date类型，但当前脚本中event[23]、event[24]属于越界索引，实际获取的是null或非日期值，导致参数类型不匹配。

原因：getRange(9,13,sheet.getLastRow()-1,24)表示从第9行第13列（M列）开始，取sheet.getLastRow()-1行、24列的数据。但数组索引从0开始，第13列对应event[0]，24列的范围最多到event[23]，event[24]已经超出数组长度，返回undefined。

修复：根据Sheet实际列位置修正索引，比如从截图看：

• 服务标题（Service Description）在Q列（第17列），对应数组索引为17-13=4 → event[4]
• 开始时间（Start Time）在X列（第24列），对应数组索引为24-13=11 → event[11]
• 结束时间（End Time）在Y列（第25列），对应数组索引为25-13=12 → event[12]

修改addEvent和updateEvent中的变量索引，示例：

// addEvent函数内修正
let title = event[4];
let description = event[5];
let location = event[6];
let emails = event[7];
let startTime = event[11];
let endTime = event[12];

2. 单元格范围错误 #

updateCalendar中getRange(9,13,sheet.getLastRow()-1,24)的行数计算错误：从第9行开始，实际有效行数应为sheet.getLastRow() - 8（而非sheet.getLastRow()-1），否则会包含大量空行，导致数组中出现无效数据。

修复：修改为：

let events = sheet.getRange(9,13,sheet.getLastRow()-8,13).getValues();

（注：13为从M列到Y列的总列数，根据实际列数调整）

3. 写入范围语法错误 #

sheet.getRange(i + 9, 21, 9, ).setValues([returnedData]);存在语法错误：列数参数为空，且行数设为9不符合返回值长度（返回值是长度为2的数组，对应1行2列）。

修复：修改为：

sheet.getRange(i + 9, 21, 1, 2).setValues([returnedData]);

4. 额外验证步骤 #

• 检查Sheet和Google Calendar的时区是否一致（Sheet设置：文件>设置>时区；Calendar设置：设置>时区）
• 在addEvent中添加日志验证时间类型：

  console.log("开始时间类型：", typeof startTime, startTime);
  console.log("结束时间类型：", typeof endTime, endTime);
  

  若输出不是object（Date类型），需确保单元格内是真正的日期值，而非文本格式的日期。

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