如何在GAS中设置从指定时刻起每日每15分钟精准执行的时间触发器

实现方案 #

你原来的实现方式存在两个核心问题：

1. 手动枚举所有执行时间点，单次创建数十个触发器，远超Google Apps Script的单项目触发器配额限制，同时会触发重复执行、冲突报错
2. 使用after方法时对过去的时间取了绝对值，会导致已过时间点的触发器被创建后立即执行，逻辑混乱

以下是仅需2个触发器即可实现需求的稳定方案：

// 配置项，可根据需求自行修改
const DAILY_START_HOUR = 11; // 每日开始执行小时
const DAILY_START_MINUTE = 1; // 每日开始执行分钟
const DAILY_END_HOUR = 21; // 每日结束执行小时
const DAILY_END_MINUTE = 1; // 每日结束执行分钟
const INTERVAL_MINUTES = 15; // 执行间隔分钟
const TARGET_FUNCTION = "function_Triggered"; // 要触发的目标函数名

// 首次使用手动运行一次即可，创建每日初始化触发器
function setDailyInitTrigger() {
  // 先删除已有的初始化触发器，避免重复创建
  const triggers = ScriptApp.getProjectTriggers();
  triggers.forEach(t => {
    if (t.getHandlerFunction() === "dailyInit") {
      ScriptApp.deleteTrigger(t);
    }
  });
  // 创建每日固定时间运行的初始化触发器
  ScriptApp.newTrigger("dailyInit")
    .timeBased()
    .atHour(DAILY_START_HOUR)
    .nearMinute(DAILY_START_MINUTE - 1 > 0 ? DAILY_START_MINUTE - 1 : 0)
    .everyDays(1)
    .create();
}

// 每日初始化函数，自动运行无需手动触发
function dailyInit() {
  // 删除所有目标函数的历史触发器
  deleteTriggers();
  const now = new Date();
  const firstRunTime = new Date(now.getFullYear(), now.getMonth(), now.getDate(), DAILY_START_HOUR, DAILY_START_MINUTE);
  // 计算距离第一次运行的时间差
  let delayMs = firstRunTime.getTime() - now.getTime();
  // 如果已经过了今天第一次运行时间，就直接触发
  if (delayMs < 0) {
    function_Triggered();
    return;
  }
  // 创建第一次执行的触发器
  ScriptApp.newTrigger(TARGET_FUNCTION)
    .timeBased()
    .after(delayMs)
    .create();
}

function deleteTriggers() {
  const triggers = ScriptApp.getProjectTriggers();
  triggers.forEach(t => {
    if (t.getHandlerFunction() === TARGET_FUNCTION) {
      ScriptApp.deleteTrigger(t);
    }
  });
}

function function_Triggered() {
  // ----------------------
  // 这里写你的业务逻辑代码
  // ----------------------

  // 执行完业务逻辑后，创建下一次执行的触发器
  const now = new Date();
  const nextRunTime = new Date(now.getTime() + INTERVAL_MINUTES * 60 * 1000);
  const endTime = new Date(now.getFullYear(), now.getMonth(), now.getDate(), DAILY_END_HOUR, DAILY_END_MINUTE);
  // 如果下一次执行时间超过当日结束时间，就不再创建
  if (nextRunTime >= endTime) {
    return;
  }
  // 先删除旧的触发器，避免残留
  deleteTriggers();
  // 创建下一次触发器
  ScriptApp.newTrigger(TARGET_FUNCTION)
    .timeBased()
    .after(INTERVAL_MINUTES * 60 * 1000)
    .create();
}

注意事项 #

• 首次部署只需要手动运行setDailyInitTrigger函数一次，授予对应权限后，后续会自动按规则循环运行
• 可直接修改代码顶部配置项的参数，调整开始/结束时间、执行间隔、目标函数名
• 请确认脚本时区和你所在时区一致，可在Google Apps Script项目设置页面修改时区配置
• 该方案同一时间最多仅存在2个触发器（1个每日初始化触发器+1个下一次执行触发器），完全不会触发配额限制和冲突报错

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