Google Apps Script跨时区适配问题：共享副本时区设置未生效

你遇到的核心问题是混淆了「服务器/脚本/表格时区」和「用户本地时区」的差异，同时代码存在变量作用域、逻辑错误等问题，具体分析和修正如下：

1. 时区获取的误区 #

ss.getSpreadsheetTimeZone()和ss.getScriptTimeZone()都无法自动获取用户的本地时区：

• getSpreadsheetTimeZone()：获取的是表格设置的时区，用户复制表格后默认继承你的EST时区，除非用户手动修改表格时区（文件>设置>时区）；
• getScriptTimeZone()：获取的是脚本项目的时区，同样默认继承原作者的设置，用户需在脚本编辑器的「项目设置」中手动修改才会生效；
• 服务器端脚本无法直接读取用户浏览器的本地时区，只能通过用户设置的表格/日历时区间接获取。

2. 代码的核心错误 #

（1）全局变量的时机错误 #

你将today、dateToCheck等变量定义在全局作用域，会在脚本启动时就完成计算（基于服务器时区），而非sendReminders()执行时的用户时区。需将这些变量移到函数内部，确保每次执行都重新计算。

（2）日期计算与循环逻辑错误 #

• getSheetValues()返回二维数组，直接toString()会导致格式异常；
• 原循环中continue语句位于循环体外，会导致数组越界；
• findEmailAddresses返回数组，直接传给GmailApp.sendEmail会触发报错。

3. 修正后的代码 #

改用用户日历的时区（更贴合用户实际使用场景，无需额外设置），并修复所有逻辑问题：

function sendReminders() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName("dashboard");
  const inputColumn = 6;
  const daysRow = 5;
  const subjectRow = 7;
  const bodyRow = 9;
  
  // 获取用户日历的时区（用户日历时区通常与实际使用时区一致）
  const providerEmail = ss.getOwner().getEmail();
  const activeCal = CalendarApp.getCalendarById(providerEmail);
  const timeZone = activeCal.getTimeZone();
  
  // 基于当前时间计算目标日期
  const today = new Date();
  const daysInAdvance = sheet.getSheetValues(daysRow, inputColumn, 1, 1)[0][0];
  const dateToCheck = new Date(today.getTime() + daysInAdvance * 24 * 60 * 60 * 1000);
  const date = Utilities.formatDate(dateToCheck, timeZone, "MMMM dd, yyyy");
  
  // 读取模板内容
  const subjectLine = sheet.getSheetValues(subjectRow, inputColumn, 1, 1)[0][0].toString();
  const emailBodyTemplate = sheet.getSheetValues(bodyRow, inputColumn, 1, 1)[0][0].toString();
  const options = {}; // 补充你的邮件配置项，比如抄送、附件等
  
  // 遍历日历事件发送提醒
  const events = activeCal.getEventsForDay(dateToCheck);
  for (let i = 0; i < events.length; i++) {
    const event = events[i];
    const emailAddresses = findEmailAddresses(event.getTitle());
    
    if (!emailAddresses) continue; // 跳过无邮箱的事件
    
    const timeOfSession = event.getStartTime();
    const formattedTime = Utilities.formatDate(timeOfSession, timeZone, "h:mm a");
    let emailBody = emailBodyTemplate.replace(/<date>/g, date);
    emailBody = emailBody.replace(/<time>/g, formattedTime);
    
    GmailApp.sendEmail(emailAddresses, subjectLine, emailBody, options);
  }
}

function findEmailAddresses(text) {
  const emailRegex = /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/g;
  const matches = text.match(emailRegex);
  return matches ? matches.join(", ") : ""; // 转成逗号分隔的字符串，避免数组报错
}

4. 给用户的使用提示 #

如果用户需要完全匹配自己的本地时区，可让他们：

1. 打开复制后的表格，进入「文件>设置」修改时区为自己所在时区；
2. （可选）在脚本编辑器的「项目设置」中，将脚本时区同步为表格时区。

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