如何在JavaScript中基于用户时区计算两个日期时间的天数差

一、按用户本地时区计算天数差 #

要根据用户所在位置的时区计算两个带时间日期的天数差，核心是剥离时间部分，仅基于本地时区的“纯日期”做差值，自动适配月末、年末等跨期场景。

实现逻辑 #

• 将输入的UTC时间字符串转为Date对象，它会自动适配用户本地时区
• 提取两个日期在本地时区的年、月、日，构造仅保留日期的新Date对象（时分秒归零）
• 通过时间戳差值除以一天的毫秒数（86400000），得到整数天数差

代码实现 #

function getLocalTimeDayDiff(dateStr1, dateStr2) {
  const date1 = new Date(dateStr1);
  const date2 = new Date(dateStr2);

  // 转换为本地时区的纯日期（时分秒归零）
  const localDate1 = new Date(date1.getFullYear(), date1.getMonth(), date1.getDate());
  const localDate2 = new Date(date2.getFullYear(), date2.getMonth(), date2.getDate());

  // 计算天数差
  const diffMs = localDate2 - localDate1;
  return Math.floor(diffMs / (1000 * 60 * 60 * 24));
}

// 测试示例
console.log(getLocalTimeDayDiff("2023-04-07T04:58:00.000Z", "2023-04-07T17:58:00.000Z"));
// CDT时区返回1，UTC时区返回0

// 月末场景测试：UTC的2023-03-31T23:00:00.000Z 和 2023-04-01T01:00:00.000Z
// 东八区返回0，西五区返回1
console.log(getLocalTimeDayDiff("2023-03-31T23:00:00.000Z", "2023-04-01T01:00:00.000Z"));

// 年末场景测试：UTC的2023-12-31T22:00:00.000Z 和 2024-01-01T02:00:00.000Z
// 东八区返回0，西五区返回1
console.log(getLocalTimeDayDiff("2023-12-31T22:00:00.000Z", "2024-01-01T02:00:00.000Z"));

二、计算UTC时区下的天数差 #

要忽略本地时区影响，直接返回UTC维度的天数差，只需基于UTC的日期信息构造纯日期对象即可。

代码实现 #

function getUTCDayDiff(dateStr1, dateStr2) {
  const date1 = new Date(dateStr1);
  const date2 = new Date(dateStr2);

  // 转换为UTC纯日期（时分秒归零）
  const utcDate1 = new Date(Date.UTC(date1.getUTCFullYear(), date1.getUTCMonth(), date1.getUTCDate()));
  const utcDate2 = new Date(Date.UTC(date2.getUTCFullYear(), date2.getUTCMonth(), date2.getUTCDate()));

  // 计算天数差
  const diffMs = utcDate2 - utcDate1;
  return Math.floor(diffMs / (1000 * 60 * 60 * 24));
}

// 测试示例
console.log(getUTCDayDiff("2023-04-07T04:58:00.000Z", "2023-04-07T17:58:00.000Z"));
// 任意时区均返回0

// 月末UTC场景测试
console.log(getUTCDayDiff("2023-03-31T23:00:00.000Z", "2023-04-01T01:00:00.000Z"));
// 返回1

// 年末UTC场景测试
console.log(getUTCDayDiff("2023-12-31T22:00:00.000Z", "2024-01-01T02:00:00.000Z"));
// 返回1

关键说明 #

• 两个函数都通过归零时分秒避免同一天内不同时间点对天数差的干扰
• 本地时区函数使用getFullYear()等本地方法，UTC函数使用getUTCFullYear()等UTC专属方法
• Date对象会自动处理月份/年份溢出，无需额外判断月末、年末的跨期逻辑

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