Google Apps Script按日自动行分组00:00-01:00区间拆分问题

问题根因 #

你遇到的拆分分组问题核心是时区不统一，本质是两处日期逻辑用了不同的时区基准：

1. 你用createTextFinder查找日期行时，匹配的是工作表单元格的显示值，该值基于工作表设置的时区生成
2. 后面判断日期是否变更的periodHasChanged方法中，用了Date.getDate()/getMonth()/getYear()这类原生方法，返回值是基于Google Apps Script运行环境的脚本时区生成
   两个时区不一致时，凌晨00:00-01:00的时间很容易出现日期偏移：比如工作表时区是GMT+8、脚本时区是GMT时，单元格显示的2024/5/20 00:30，在脚本时区实际还是2024/5/19 16:30，getDate()返回的日期是19，和当天01:30之后的日期返回值20不一致，就会被判定为日期变更，拆分成两个分组。

修复方案 #

1. 统一所有日期逻辑的时区基准 #

所有日期格式化、日期判断都统一使用工作表时区，替换掉所有Session.getScriptTimeZone()：
首先全局定义统一时区，避免重复调用：

const ss = SpreadsheetApp.getActiveSpreadsheet();
const SHEET_TIME_ZONE = ss.getSpreadsheetTimeZone();
const logSheetName = "LOG";

替换groupDays/groupMonths/groupYears中所有格式化日期的时区参数，比如groupDays中的：

// 原代码
var getDayMonthYear = Utilities.formatDate(dateDay, Session.getScriptTimeZone(), "dd/MM/YYYY");
// 替换为
var getDayMonthYear = Utilities.formatDate(dateDay, SHEET_TIME_ZONE, "dd/MM/YYYY");

2. 重写日期变更判断逻辑 #

不要用Date原生的本地时间方法，统一用工作表时区格式化后再对比，避免时区偏移：

function periodHasChanged(currDate, prevDate, period) {
    switch (period) {
        case 'year':
            var currPeriod = Utilities.formatDate(currDate, SHEET_TIME_ZONE, "YYYY");
            var prevPeriod = Utilities.formatDate(prevDate, SHEET_TIME_ZONE, "YYYY");
            break;
        case 'month':
            var currPeriod = Utilities.formatDate(currDate, SHEET_TIME_ZONE, "YYYY-MM");
            var prevPeriod = Utilities.formatDate(prevDate, SHEET_TIME_ZONE, "YYYY-MM");
            break;
        case 'date':
            var currPeriod = Utilities.formatDate(currDate, SHEET_TIME_ZONE, "YYYY-MM-dd");
            var prevPeriod = Utilities.formatDate(prevDate, SHEET_TIME_ZONE, "YYYY-MM-dd");
            break;
    }
    return currPeriod !== prevPeriod;
}

3. 可选：校验分组行号计算逻辑 #

你当前createGroup中的行号计算存在边界错误风险：

// 原代码
var range = `${rowStart + rangeStart + 1}:${rowStart + rangeEnd}`;

建议增加日志打印确认行号是否正确，若出现分组错位可以根据实际行号调整偏移量。

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