/** * 会话列表的时间处理与分组。 * * 「今天 / 昨天 / 更早」这三个分组的判定看起来简单,但有几个必须处理好的点: * * 1. **按本地日历日比较,不是按 24 小时差** * 凌晨 1 点看到「昨天 23:00 的对话」,如果按「相差不到 24 小时」算, * 它会被归到「今天」,与用户的直觉不符。 * 2. **时间是 ISO 字符串且不带时区** * 后端返回的是 LocalDateTime(如 2026-10-09T10:32:24), * `new Date('2026-10-09T10:32:24')` 在浏览器里按**本地时区**解析, * 行为正好符合预期;但如果哪天后端改成带 Z 的格式, * 这里的比较逻辑需要跟着调整(所以集中在本文件里处理)。 * 3. **置顶会话单独成组** * 它们已经按「置顶先后」排好序,再做时间分组反而会把顺序打乱。 */ const DAY_MS = 24 * 60 * 60 * 1000 /** 解析后端时间;无法解析时返回 null,由调用方兜底 */ export function parseTime(value) { if (!value) return null if (value instanceof Date) return value const date = new Date(value) return Number.isNaN(date.getTime()) ? null : date } function startOfDay(date) { return new Date(date.getFullYear(), date.getMonth(), date.getDate()) } /** * 相差几个「日历日」。 * 0=今天,1=昨天,2=前天…… 只按日期算,忽略具体时刻。 */ export function daysAgo(date, now = new Date()) { if (!date) return Number.MAX_SAFE_INTEGER const diff = startOfDay(now).getTime() - startOfDay(date).getTime() return Math.round(diff / DAY_MS) } function pad(n) { return String(n).padStart(2, '0') } /** * 列表项上显示的日期文本 —— 用户明确要求「列表里要能看到日期」, * 所以这里始终带上日期,而不是只给一个 HH:mm。 * * 今天 → 今天 10:32 * 昨天 → 昨天 10:32 * 今年 → 10-09 10:32 * 往年 → 2025-10-09 10:32 */ export function formatChatTime(value, now = new Date()) { const date = parseTime(value) if (!date) return '' const time = `${pad(date.getHours())}:${pad(date.getMinutes())}` const ago = daysAgo(date, now) if (ago === 0) return `今天 ${time}` if (ago === 1) return `昨天 ${time}` if (date.getFullYear() === now.getFullYear()) { return `${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${time}` } return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${time}` } /** 完整时间,用于 hover 提示 */ export function formatFullTime(value) { const date = parseTime(value) if (!date) return '' return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ` + `${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}` } /** 相对时间,用于归档列表这类不强调精确时刻的地方 */ export function formatRelative(value, now = new Date()) { const date = parseTime(value) if (!date) return '' const ago = daysAgo(date, now) if (ago === 0) return '今天' if (ago === 1) return '昨天' if (ago < 30) return `${ago} 天前` if (date.getFullYear() === now.getFullYear()) { return `${date.getMonth() + 1} 月 ${date.getDate()} 日` } return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}` } /** * 把会话列表按「置顶 / 今天 / 昨天 / 更早」分组。 * * @param {Array} chats 后端已排好序的列表(置顶在前,其余按最近活跃倒序) * @returns {Array<{key:string,label:string,chats:Array}>} 只返回非空分组 * * 注意:组内顺序**完全沿用后端顺序**,这里只做分桶,不排序。 */ export function groupChats(chats, now = new Date()) { const list = Array.isArray(chats) ? chats : [] const pinned = [] const today = [] const yesterday = [] const earlier = [] for (const chat of list) { if (chat.pinned) { pinned.push(chat) continue } // 分组依据用「最近活跃时间」:用户对「这段对话是什么时候的」的记忆 // 通常来自最后一次交谈,而不是创建时间 const ago = daysAgo(parseTime(chat.updatedAt || chat.createdAt), now) if (ago <= 0) today.push(chat) else if (ago === 1) yesterday.push(chat) else earlier.push(chat) } const groups = [] if (pinned.length) groups.push({ key: 'pinned', label: '置顶', chats: pinned }) if (today.length) groups.push({ key: 'today', label: '今天', chats: today }) if (yesterday.length) groups.push({ key: 'yesterday', label: '昨天', chats: yesterday }) if (earlier.length) groups.push({ key: 'earlier', label: '更早', chats: earlier }) return groups }