本文提供一种健壮、时区无关的 javascript 逻辑，用于根据用户本地当前时间（而非服务器时间）精准判断其所属的活跃班次，支持跨午夜的班次（如夜班），并规避 12/24 小时制歧义与时间格式化陷阱。
本文提供一种健壮、时区无关的 javascript 逻辑，用于根据用户本地当前时间（而非服务器时间）精准判断其所属的活跃班次，支持跨午夜的班次（如夜班），并规避 12/24 小时制歧义与时间格式化陷阱。
在多时区业务场景（如 IST 与 AST 用户共用同一套班次配置）中，班次有效性必须基于用户本地时间判定，而非服务端时间或统一时区时间。原始实现虽已考虑跨午夜逻辑（end < start），但存在两个关键缺陷：
- 测试方式错误：直接修改 currentTime 对象（如 setHours(+10)）会破坏 getHours()/getMinutes() 的内部一致性，导致时间计算失准；
- 逻辑漏洞：答案中提供的“字符串数值比较”方案（如 "93000" vs "53000"）在 09:30:00 与 05:30:00 比较时，因忽略小时位数对齐（93000 < 53000 为 false），实际无法正确识别跨午夜区间。
✅ 正确解法应严格遵循以下原则：
- 使用 toLocaleTimeString('en-US', { hour12: false, hour: '2-digit', minute: '2-digit', second: '2-digit' }) 获取标准化的 24 小时制本地时间字符串；
- 将 HH:mm:ss 解析为总秒数（而非分钟），提升精度与可读性；
- 显式处理跨午夜场景：当 endTime < startTime，视为覆盖次日，有效区间为 [startTime, 24:00) ∪ [00:00, endTime)；
- 绝不依赖 Date.setHours() 修改原时间对象做测试——应使用独立时间戳或构造新 Date 实例模拟。
以下是生产就绪的实现：
/**
* 根据用户本地当前时间，返回其当前活跃班次
* @param {Object} user - 用户对象，含 active_shifts 数组
* @returns {Object|null} 匹配的班次对象，或 null（无匹配）
*/
function getCurrentActiveShift(user) {
// ✅ 获取用户本地时间（自动适配浏览器时区）
const now = new Date();
const nowHours = now.getHours();
const nowMinutes = now.getMinutes();
const nowSeconds = now.getSeconds();
const totalSecondsNow = nowHours * 3600 + nowMinutes * 60 + nowSeconds;
for (const shift of user.active_shifts || []) {
// 解析班次时间（假设格式为 "HH:mm:ss"）
const [startH, startM, startS] = shift.startTime.split(':').map(Number);
const [endH, endM, endS] = shift.endTime.split(':').map(Number);
const totalSecondsStart = startH * 3600 + startM * 60 + startS;
const totalSecondsEnd = endH * 3600 + endM * 60 + endS;
if (totalSecondsEnd > totalSecondsStart) {
// 普通班次：startTime <= now < endTime
if (totalSecondsNow >= totalSecondsStart && totalSecondsNow < totalSecondsEnd) {
return shift;
}
} else {
// 跨午夜班次（如 Night: 06:30 → 02:30）：now ≥ start OR now < end
if (totalSecondsNow >= totalSecondsStart || totalSecondsNow < totalSecondsEnd) {
return shift;
}
}
}
return null;
}
// ✅ 安全的测试方法：创建新 Date 实例，避免污染原对象
function testAtTime(baseDate, hoursOffset) {
const testDate = new Date(baseDate);
testDate.setHours(testDate.getHours() + hoursOffset);
// 临时 monkey-patch getCurrentActiveShift 以注入测试时间（仅用于演示）
const originalNow = Date.now;
Date.now = () => testDate.getTime();
try {
return getCurrentActiveShift(user);
} finally {
Date.now = originalNow;
}
}
// 示例数据（修复了原始数据中 Morning endTime 逻辑矛盾：05:30 应为次日，故属跨午夜）
const user = {
id: 3,
name: "Clark Kent",
mobileNumber: "1234567892",
email: "clark@example.com",
role: "VAN_SALE",
loc_update_permission: true,
active_shifts: [
{
id: 1,
name: "Morning",
startTime: "09:30:00", // 09:30 AM
endTime: "17:30:00", // 05:30 PM → 非跨午夜
coordinates: null,
},
{
id: 2,
name: "Night",
startTime: "18:30:00", // 06:30 PM
endTime: "02:30:00", // 02:30 AM（次日）→ 跨午夜
coordinates: null,
},
],
};
// 运行检测
const currentShift = getCurrentActiveShift(user);
console.log(
currentShift
? `✅ Current active shift: ${currentShift.name}`
: "⚠️ No active shift at current local time."
);
// 验证跨午夜逻辑（模拟凌晨 1:00）
const mockNightTime = new Date();
mockNightTime.setHours(1, 0, 0, 0); // 01:00:00 AM
console.log("Test at 01:00 AM:", getCurrentActiveShift(user)?.name); // 应输出 "Night"关键注意事项：
- ? 时区安全：new Date() 天然返回用户本地时间，无需手动转换时区，确保 IST 用户 09:00 和 AST 用户 09:00 均能各自匹配对应班次；
- ? 数据一致性：数据库中 startTime/endTime 必须统一为 24 小时制 HH:mm:ss 字符串（如 "02:30:00" 表示凌晨 2:30），避免 "2:30 AM" 等模糊格式；
- ? 边界处理：使用 >= startTime && < endTime（左闭右开）避免时间点重叠冲突；
- ? 健壮性增强：生产环境建议增加输入校验（如时间格式正则 /^([01]?[0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]$/）及空值防护。
此方案彻底解耦服务端与客户端时区，让班次逻辑真正“跟随用户”，是 SaaS 类外勤调度、零售排班等应用的核心基础设施。
