本文详解如何在 Go 中安全、无损地将 int64 类型的 Unix 纳秒时间戳（如 time.Now().UnixNano()）准确转换回 time.Time 对象，并强调 SQLite 存储与类型对齐的关键注意事项。
本文详解如何在 go 中安全、无损地将 `int64` 类型的 unix 纳秒时间戳（如 `time.now().unixnano()`）准确转换回 `time.time` 对象，并强调 sqlite 存储与类型对齐的关键注意事项。
在 Go 应用中，将高精度时间持久化到数据库（尤其是 SQLite）时，常采用 time.Now().UnixNano() 获取纳秒级整数时间戳并存入 INTEGER 列——这能规避时区、格式解析等问题，也便于数值排序与范围查询。但一个常见误区是：误用 time.Unix(sec, nsec) 的参数语义，导致还原失败。
正确做法是：将 UnixNano() 返回的完整纳秒值作为纳秒部分传入 time.Unix(0, ns)，秒部分设为 0。因为 UnixNano() 返回的是自 Unix 纪元起的总纳秒数，而 time.Unix(sec, nsec) 的设计是 sec 表示秒数、nsec 表示该秒内的纳秒偏移（范围 0–999,999,999）。若直接将纳秒总数传给 sec 参数（如 time.Unix(ns, 0)），会因整数溢出和语义错位造成时间严重偏差（例如变成公元 2300+ 年）。
✅ 正确转换示例：
t1 := time.Now()
ns := t1.UnixNano() // e.g., 1718234567890123456
// ✅ 正确：秒部分为 0，纳秒部分为完整纳秒值
t2 := time.Unix(0, ns)
fmt.Println("Original:", t1.UnixNano(), t1.Format(time.RFC3339))
fmt.Println("Restored:", t2.UnixNano(), t2.Format(time.RFC3339))
// 输出完全一致，验证无损还原⚠️ 关键注意事项：
-
SQLite INTEGER 列可安全存储 int64（SQLite 的 INTEGER 是带符号 64 位整数），UnixNano() 返回的 int64 值（最大约 9.2e18，远小于 2^63-1 ≈ 9.2e18）不会溢出，但需确保数据库驱动未做隐式类型截断（如某些旧版驱动或 ORM 可能将大整数转为 int）。建议显式使用 int64 绑定：
stmt.Exec(int64(t.UnixNano()), command, data)
- 读取时务必用 int64 接收：从 *sqlite3.Stmt 或 Rows.Scan() 获取时间戳时，应声明为 var ts int64，而非 int 或 int32，避免平台相关截断。
- 时区一致性：time.Unix(0, ns) 默认返回 UTC 时间。若业务需本地时区，可在还原后调用 .In(loc) 转换，但推荐全程以 UTC 存储和计算，仅在展示层转换时区。
? 总结：UnixNano() ↔ time.Unix(0, ns) 是 Go 中纳秒级时间往返转换的标准、零开销方案。其可靠性依赖两点：一是严格遵循 time.Unix(sec, nsec) 的参数契约；二是端到端保障 int64 类型完整性——从 Go 变量、SQL 绑定、SQLite 列定义到读取解析，均不发生隐式降级。只要满足这两点，时间精度即可完整保留，彻底解决“还原后时间不匹配”的问题。
