本文介绍如何将数据库中存储的纳秒级时间戳（如 createdAtNanos）准确转换为用户友好的相对时间字符串（例如“2小时前”），重点解决时区偏差、单位换算及边界逻辑问题。
本文介绍如何将数据库中存储的纳秒级时间戳（如 `createdatnanos`）准确转换为用户友好的相对时间字符串（例如“2小时前”），重点解决时区偏差、单位换算及边界逻辑问题。
在实际开发中，许多后端系统（尤其是使用 Protobuf、gRPC 或高性能数据库如 CockroachDB、TiDB）会以纳秒精度（nanoseconds since Unix epoch）存储时间戳。但前端 JavaScript 的 Date 对象和主流时间库（如 Moment.js）仅支持毫秒级精度，因此直接传入纳秒值会导致时间错乱——例如显示为“1970 年前”。
正确做法是：先将纳秒转换为毫秒（除以 1,000,000），再统一在 UTC 时区下进行计算。这是因为 Unix 时间戳本质是 UTC 时间，若忽略时区，本地时区偏移会引入误差（尤其在跨日或夏令时场景下）。
以下是优化后的实现（使用 moment.utc() + duration.asXxx()）：
const getHoursOrMinutesAgo = (createdAtNanos) => {
const now = moment.utc(); // 当前 UTC 时间
const createdAtMilliseconds = Math.floor(createdAtNanos / 1_000_000); // 纳秒 → 毫秒（取整防浮点误差）
const createdAt = moment.utc(createdAtMilliseconds);
const duration = moment.duration(now.diff(createdAt));
const hoursAgo = Math.floor(duration.asHours());
const minutesAgo = Math.floor(duration.asMinutes()) % 60;
const secondsAgo = Math.floor(duration.asSeconds()) % 60;
if (hoursAgo > 0) {
return `${hoursAgo} hora(s) atrás`;
} else if (minutesAgo > 0) {
return `${minutesAgo} minuto(s) atrás`;
} else {
return `${secondsAgo} segundo(s) atrás`;
}
};✅ 关键改进说明：
- 使用 moment.utc() 替代 moment()，避免本地时区干扰；
- 用 duration.asHours() 等方法获取总时长的线性值（而非 duration.hours() 这种只返回“钟表小时”的截断值），确保 2.5 小时返回 2，而非 0；
- Math.floor() 防止浮点数导致的 0.999 类误差；% 60 保证分钟/秒始终在合理范围内（如 125 秒 → 2 min 5 sec）；
- createdAtNanos / 1_000_000 后显式 Math.floor()，消除大数除法的精度丢失风险。
⚠️ 注意事项：
- Moment.js 已进入维护模式，生产环境建议逐步迁移至 Luxon 或 date-fns（后者需配合 nanoid 或自定义纳秒处理）；
- 若需支持“刚刚”“1 天前”“2 周前”等更丰富格式，可扩展条件分支或使用 moment.fromNow()（但需确保输入时间已正确转为 UTC）；
- 数据库写入时务必确认 createdAtNanos 是标准 Unix 纳秒时间戳（即从 1970-01-01T00:00:00Z 开始计数），而非 JVM System.nanoTime() 等相对值。
该方案兼顾准确性、可读性与国际时间规范，适用于多时区 SaaS 应用的时间展示场景。
