在很多业务场景里都需要计算两个时间点之间的小时差，比如夜间加班排班、充电桩夜间计费、酒店入住时长统计等。这类需求有一个共同特点：时间段经常跨越午夜，例如从晚上22点持续到次日凌晨6点。如果只是简单地把两个时刻字符串做减法，很容易得到负数或者错误的结果。Day.js作为一款轻量的日期处理库，提供了简洁的diff方法和丰富的插件体系，能够优雅地解决这类问题。本文将结合实际案例，详细讲解如何用Day.js精确计算跨午夜时间段的小时差，并覆盖边界校验、格式化输出等细节。
一、diff方法的基本原理与单位换算
Day.js的核心计算能力体现在diff方法上。它的签名是diff(date, unit, float)，第一个参数是要比较的目标时间，第二个参数是计算单位，第三个参数决定是否返回带小数的浮点值。理解这个方法的计算方向很重要：结果等于目标时间减去调用者自身，即a.diff(b)表示b到a之间经过了多久。
需要注意单位换算的细节。当单位是小时时，diff默认对结果做向下取整。比如从22:00到次日06:00实际是8小时，但如果时间点是22:30到06:15，实际时长为7小时45分钟，直接用diff('hour')会得到7而不是7.75。想要拿到精确的小数结果，必须传入第三个参数true：
const dayjs = require('dayjs');
const start = dayjs('2024-05-01 22:30');
const end = dayjs('2024-05-02 06:15');
// 不传第三个参数，结果向下取整
console.log(end.diff(start, 'hour')); // 7
// 传 true 得到精确浮点值
console.log(end.diff(start, 'hour', true)); // 7.75
// 换算成分钟再除以60也是常见做法
console.log(end.diff(start, 'minute') / 60); // 7.75另一个容易踩的坑是时间顺序。如果调用者比目标时间更晚，diff会返回负数。跨午夜场景下如果输入顺序不确定，一定要先做比较。Day.js提供了isBefore、isAfter两个方法用于判断先后关系，配合使用可以保证计算总是得到正数时长。
二、跨午夜场景的完整处理方案
跨午夜之所以麻烦，是因为很多系统只存储了时刻字符串而没有日期。假设排班系统里只记录了上班时间22:00和下班时间06:00，直接解析会得到两个同一天的时间点，diff的结果变成负数。解决思路是：如果结束时刻早于开始时刻，就把结束时刻的日期加一天，表示它落在次日。
const dayjs = require('dayjs');
/**
* 计算跨午夜时间段的时长（小时）
* @param {string} startHM 开始时刻，如 "22:00"
* @param {string} endHM 结束时刻，如 "06:00"
* @param {string} baseDate 基准日期，如 "2024-05-01"
*/
function calcDurationHours(startHM, endHM, baseDate) {
const start = dayjs(`${baseDate} ${startHM}`);
let end = dayjs(`${baseDate} ${endHM}`);
// 结束时刻早于开始，说明跨越了午夜，日期加一天
if (end.isBefore(start)) {
end = end.add(1, 'day');
}
return end.diff(start, 'hour', true);
}
console.log(calcDurationHours('22:00', '06:00', '2024-05-01')); // 8
console.log(calcDurationHours('09:00', '18:00', '2024-05-01')); // 9（未跨午夜也正确）
console.log(calcDurationHours('23:30', '00:15', '2024-05-01')); // 0.75这段代码的关键在于add(1, 'day')的时机判断。只有当结束时刻在数值上早于开始时刻时才加一天，白天班次不受影响。还需要考虑一个特殊边界：开始和结束时刻完全相同怎么处理？业务上一般有两种解释，一是时长为零，二是刚好一个整天即24小时。建议在函数里显式处理这种情况，避免歧义。
为了提升代码的健壮性，还可以加入输入校验。利用dayjs对象.isValid()方法可以判断解析是否成功，如果用户传入了格式错误的时间字符串，应当及时抛出异常或返回错误码，而不是带着无效值继续计算：
function safeCalcDuration(startHM, endHM, baseDate) {
const start = dayjs(`${baseDate} ${startHM}`);
const end = dayjs(`${baseDate} ${endHM}`);
if (!start.isValid() || !end.isValid()) {
throw new Error('时间格式不正确，请使用 HH:mm 格式');
}
const realEnd = end.isBefore(start) ? end.add(1, 'day') : end;
return realEnd.diff(start, 'hour', true);
}三、与原生Date对比及插件扩展
有人可能会问，用原生Date的getTime相减不也能算吗？确实可以，但原生Date的解析能力很弱，对非标准格式的字符串兼容性各浏览器表现不一，尤其是iOS的Safari对2024-05-01 22:00这种格式解析经常返回Invalid Date。而Day.js统一了解析行为，配合customParseFormat插件还能强制指定输入格式，稳定性高很多。
const dayjs = require('dayjs');
const customParseFormat = require('dayjs/plugin/customParseFormat');
dayjs.extend(customParseFormat);
// 强制按 HH:mm 格式解析，避免各浏览器差异
const start = dayjs('22:00', 'HH:mm');
const end = dayjs('06:00', 'HH:mm').add(1, 'day');
console.log(end.diff(start, 'hour', true)); // 8在国际化或者跨时区场景下，还要注意时区问题。如果数据来自不同时区的服务器，建议使用utc和timezone插件，先把时间统一转换到同一时区再做diff，否则计算结果会混入时区偏移量。此外，如果需要把结果格式化成「x小时y分钟」的可读形式，可以先算总分钟数再做简单取余运算，配合duration插件还能进一步简化代码。
总结一下，用Day.js计算跨午夜时间段的要点有三个：一是diff的第三个参数传true拿到精确小数，二是用isBefore判断是否需要给结束时间加一天，三是借助插件规范解析格式和时区。掌握了这三点，无论是夜间计费还是跨天排班，都能写出精确可靠的时间差计算逻辑。