在Google Apps Script中使用Date()时，1/1/2023为何变为12/31/2022？

核心问题根源 #

1. 时区差异：Google Sheets单元格显示的1/1/2023是你的本地时区（EET）日期，但Apps Script默认以GMT-5时区执行，读取后会转换为对应时区的时间（Sat Dec 31 16:00:00 GMT-05:00 2022），这是时区转换的正常现象，并非错误。
2. 日期运算的类型陷阱：Date对象与数字的运算规则存在差异，加上setDate方法的副作用，导致了你看到的异常结果。

逐个测试的问题解释 #

测试1：直接读取单元格日期加减 #

• 减法有效：aDate - MILLIS_PER_DAY中，减号会触发Date对象的valueOf()方法，自动转换为时间戳（数字），运算后转Date自然正确。
• 加法无效：aDate + MILLIS_PER_DAY中，加号会触发Date对象的toString()方法，变成字符串与数字拼接（比如"Sat Dec 31 16:00:00 GMT-05:00 2022" + 432000000），最终字符串无法被正确解析为新日期，所以返回原日期。

测试2：用Utilities.formatDate格式化后处理 #

Utilities.formatDate返回的是字符串类型的日期，而非Date对象。字符串与数字做加减运算时会被强制转换为NaN（非法数字），new Date(NaN)会返回Unix纪元起始前的日期（Wed Dec 31 19:00:00 GMT-05:00 1969），这是预期的错误结果。

测试3：使用setDate方法的异常 #

setDate方法会直接修改原Date对象，并返回修改后的时间戳：

• 第一次d.setDate(d.getDate() + 5)：将d从Dec 31 2022修改为Jan 05 2023
• 第二次d.setDate(d.getDate() - 5)：此时d的日期是Jan 05，减5天后回到Dec 31，并非“无效”，而是基于修改后的日期运算的结果
• 第三次d.setDate(d.getDate() - 20)：此时d回到了Dec 31，减20天后得到Dec 11，结果正确

正确的日期运算方案 #

方案1：基于时间戳的运算（推荐） #

通过getTime()获取Date对象的时间戳（毫秒数），直接对数字进行加减，避免类型转换陷阱：

function correctDateMath() {
    const spreadsheet = SpreadsheetApp.getActive();
    const MILLIS_PER_DAY = 1000 * 60 * 60 * 24; // 单天毫秒数
    const aDate = spreadsheet.getRange('J4').getValue();
    
    // 加5天
    const plus5Days = new Date(aDate.getTime() + MILLIS_PER_DAY * 5);
    // 减5天
    const minus5Days = new Date(aDate.getTime() - MILLIS_PER_DAY * 5);
    
    Logger.log(plus5Days);
    Logger.log(minus5Days);
}

方案2：使用setDate时避免修改原对象 #

每次运算前复制原Date对象，确保基于初始日期操作：

function safeSetDate() {
    const spreadsheet = SpreadsheetApp.getActive();
    const aDate = spreadsheet.getRange('J4').getValue();
    
    // 复制原日期，避免修改原对象
    const d = new Date(aDate);
    const plus5 = new Date(d);
    plus5.setDate(plus5.getDate() + 5);
    
    const minus5 = new Date(d);
    minus5.setDate(minus5.getDate() - 5);
    
    Logger.log(d); // 原日期
    Logger.log(plus5); // 加5天后
    Logger.log(minus5); // 减5天后
}

时区统一处理 #

如果需要确保日期与Sheet显示一致，可以通过Utilities.formatDate将日期转换为Sheet时区的字符串后再转Date：

const sheetTimeZone = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTimeZone();
const dateStr = Utilities.formatDate(aDate, sheetTimeZone, "MM/dd/yyyy");
const localDate = new Date(dateStr);

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