Google Calendar API V3在Node.js Express中不遵循timeMin/timeMax参数问题

嘿，我之前也碰到过类似的坑，咱们一步步来拆解可能的原因：

最可能的元凶：时区不匹配 #

Google Calendar API的timeMin和timeMax默认是UTC时间，但如果你直接用new Date(Date.parse("2018-01-22"))生成日期，它会基于你的服务器本地时区转换，这就可能导致实际传递给API的时间范围和你预期的完全不一样。比如服务器在UTC+8时区的话，2018-01-22会被转成UTC的2018-01-21T16:00:00.000Z，相当于提前了一天，自然会返回更早的事件。

解决方法： #

要么明确生成UTC日期，要么给API请求指定时区：

function listEvents(auth) {
  var calendar = google.calendar('v3');
  // 方法1：用Date.UTC生成标准UTC日期（注意月份是从0开始的，1月对应0）
  const timeMin = new Date(Date.UTC(2018, 0, 22)).toISOString();
  const timeMax = new Date(Date.UTC(2018, 1, 27)).toISOString();

  // 方法2：在请求中指定你的本地时区，让API按该时区解析时间范围
  calendar.events.list({
    auth: auth,
    calendarId: 'primary',
    timeMin: timeMin,
    timeMax: timeMax,
    timeZone: 'Asia/Shanghai', // 替换成你的实际时区，比如'UTC'、'America/New_York'
    singleEvents: true,
    orderBy: 'startTime'
  }, function(err, response) {
    if (err) {
      console.log('The API returned an error: ' + err);
      return;
    }
    var events = response.items;
    if (events.length === 0) {
      console.log('No upcoming events found.');
    } else {
      // Do Some Stuff ...............
    }
  });
}

额外排查点：参数是否真的传递正确了 #

在Express环境中，偶尔会有变量被缓存、中间件意外修改参数的情况，你可以在函数里加个调试日志，确认传递的timeMin和timeMax是你预期的ISO字符串：

console.log('实际请求的时间范围:', timeMin, '→', timeMax);

如果输出的不是2018-01-22T00:00:00.000Z这类标准UTC格式，那就是日期转换的问题没解决。

补充：API的timeMax是排他性的 #

顺便提一句，timeMax是不包含该时间点的事件的，但这个只会影响刚好卡在时间点的事件，不会导致返回所有历史事件，所以大概率还是时区的锅。

内容的提问来源于stack exchange，提问作者Thilinã Nűwań Mălsăra