如何使用DayJs计算跨午夜时段的正确小时时间差

问题原因 #

dayjs().diff()方法计算的是两个时间点的实际时间跨度，当结束时间落在次日时（比如20:00到次日02:00），直接调用该方法会得到反向的时间差（-18小时，取绝对值后为18小时），但我们需要的是跨天的实际时长（6小时）。

实现方法 #

以下两种方式都能实现需求：

方法一：判断差值正负后调整

function calculateHourDiff(timeA, timeB) {
  const diff = dayjs(timeB).diff(timeA, 'hours');
  return diff >= 0 ? diff : diff + 24;
}

逻辑：如果结束时间在开始时间之后（差值为正），直接返回差值；如果结束时间在次日（差值为负），加上24小时得到跨天的实际时长。

方法二：用模运算简化处理

function calculateHourDiff(timeA, timeB) {
  const diff = dayjs(timeB).diff(timeA, 'hours');
  return ((diff % 24) + 24) % 24;
}

逻辑：模24运算可以自动处理正负差值，确保结果始终是0-23之间的有效小时数，刚好匹配跨天的最短时长需求。

测试验证

• 12:00至20:00：calculateHourDiff('2024-05-20 12:00', '2024-05-20 20:00') 返回8
• 20:00至次日02:00：calculateHourDiff('2024-05-20 20:00', '2024-05-21 02:00') 返回6

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