Google Apps Script自定义函数执行至return语句后未终止，触发最大执行时长超时错误

我仔细看了你的代码和日志，发现问题的根源出在自定义函数里不必要的单元格范围读取操作，以及一些小的逻辑细节，导致函数执行后无法正常终止，最终触发超时错误。

核心问题分析 #

从日志可以看到，代码确实执行到了return "false"语句，但函数没有正常退出，而是一直挂起到超时。这是因为你在自定义函数里使用了SpreadsheetApp.getActive()和getRange()来读取单元格值——Google Sheets的自定义函数执行环境对这类API调用的支持有限，频繁或不必要的范围访问会导致后台操作阻塞，即使代码已经执行到return，也无法及时终止函数进程。

另外还有两个次要问题：

• 你用字符串"true"/"false"作为返回值，而不是原生布尔值，这在公式里使用会不太方便
• 用VacationDays.includes(val)判断日期是否在假期里是无效的——Date是引用类型，即使两个日期时间完全相同，它们也是不同的对象，includes的严格相等判断永远会返回false

修复后的代码 #

//region Constants
const VacationDays = [
  new Date("1/1/25"),
  new Date("1/20/25"),
  new Date("2/17/25"),
  new Date("5/26/25"),
  new Date("6/19/25"),
  new Date("7/4/25"),
  new Date("9/1/25"),
  new Date("10/13/25"),
  new Date("11/11/25"),
  new Date("11/27/25"),
  new Date("12/25/25"),
  new Date("12/26/25"),
  new Date("12/27/25"),
  new Date("12/31/25"),
].map(date => date.getTime()); // 转换为时间戳数组，方便比较
//endregion

function ISWORKDAY(targetDate) {
  // 先判断传入的是否是有效日期
  if (!(targetDate instanceof Date) || isNaN(targetDate.getTime())) {
    return false;
  }

  const dayOfWeek = targetDate.getDay();
  // 判断是否是周末或假期
  const isWeekend = [0, 6].includes(dayOfWeek);
  const isVacationDay = VacationDays.includes(targetDate.getTime());

  return !(isWeekend || isVacationDay);
}

关键修改说明 #

1. 移除SpreadsheetAPI调用：直接让函数接收单元格的日期值作为参数，不需要再通过地址去读取单元格——这是解决超时的核心！
2. 日期比较优化：把假期日期数组转换成时间戳（数字），用getTime()获取目标日期的时间戳进行比较，这样就能正确判断是否是假期了
3. 返回原生布尔值：直接返回true/false，而不是字符串，更符合Google Sheets公式的使用习惯
4. 冗余假期日期清理：移除了重复的7/4/25条目
5. 完善日期有效性判断：增加了对无效日期的处理，避免出错

使用方法 #

在单元格里直接输入公式：

=ISWORKDAY(A11)

把A11替换成你要判断的日期所在的单元格即可，不需要加引号。

这样修改后，函数的执行效率会大幅提升，不会再出现超时问题，逻辑也更准确。

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