本文介绍在 Go 应用中处理 PostgreSQL interval 字段的推荐方案：通过自定义类型实现 time.Duration 与数据库 bigint 的双向转换，兼顾类型安全、可读性与兼容性，同时明确其在 SQL 层失去原生 interval 运算能力的权衡。
本文介绍在 go 应用中处理 postgresql `interval` 字段的推荐方案：通过自定义类型实现 `time.duration` 与数据库 `bigint` 的双向转换，兼顾类型安全、可读性与兼容性，同时明确其在 sql 层失去原生 interval 运算能力的权衡。
PostgreSQL 的 interval 类型用于表示时间段（如 '2 days 3 hours'），但标准 Go 数据库驱动（database/sql）及其常用 PostgreSQL 驱动（如 lib/pq 或 pgx）不原生支持将 interval 直接映射为 time.Duration。直接使用 sql.NullString 或 string 虽可读取，却丧失类型语义与时间运算能力；而尝试用 time.Time 显然逻辑错误——interval 表达的是“长度”，而非“时刻”。
因此，业界广泛采用的稳健实践是：在数据库层面将 interval 存储为等效的微秒级整数（bigint），并在 Go 端通过自定义类型封装 time.Duration，并实现 driver.Valuer 和 sql.Scanner 接口。该方案既保留了 Go 中对时间间隔的完整操作能力（如加减、格式化、比较），又确保了与 PostgreSQL 的可靠交互。
✅ 推荐实现：Duration 自定义类型
以下是一个生产就绪的封装示例（兼容 database/sql 及主流驱动）：
package model
import (
"database/sql/driver"
"fmt"
"time"
)
// Duration 是 time.Duration 的包装类型，用于与 PostgreSQL bigint 字段双向映射
type Duration time.Duration
// Value 实现 driver.Valuer 接口：将 Duration 转为 int64（微秒）
func (d Duration) Value() (driver.Value, error) {
return int64(d), nil
}
// Scan 实现 sql.Scanner 接口：从数据库值（int64 或 nil）还原为 Duration
func (d *Duration) Scan(value interface{}) error {
switch v := value.(type) {
case int64:
*d = Duration(v)
case nil:
*d = Duration(0)
default:
return fmt.Errorf("cannot scan %T into Duration", v)
}
return nil
}
// 便捷方法：转为标准 time.Duration（推荐在业务逻辑中显式调用）
func (d Duration) Duration() time.Duration {
return time.Duration(d)
}
? 在结构体中使用
更新你的 Product 结构体如下：
type Product struct {
ID int `db:"id"`
Name string `db:"name"`
Type int `db:"type"`
Price float64 `db:"price"`
ExecutionTime Duration `db:"execution_time"` // 对应 PostgreSQL 的 bigint 字段
}
⚠️ 关键前提：数据库字段类型需调整
将原 execution_time interval 改为 execution_time bigint，并确保写入时存储的是微秒数（duration.Microseconds()）。例如：ALTER TABLE products ALTER COLUMN execution_time TYPE bigint USING EXTRACT(EPOCH FROM execution_time) * 1000000;
? 使用示例
// 写入：自动调用 Value()
prod := Product{
Name: "Task A",
ExecutionTime: Duration(2*time.Hour + 30*time.Minute),
}
_, err := db.Exec("INSERT INTO products (name, execution_time) VALUES ($1, $2)",
prod.Name, prod.ExecutionTime)
if err != nil { /* handle */ }
// 查询：自动调用 Scan()
var p Product
err := db.QueryRow("SELECT name, execution_time FROM products WHERE id = $1", 1).
Scan(&p.Name, &p.ExecutionTime)
if err != nil { /* handle */ }
// 业务中安全使用
duration := p.ExecutionTime.Duration() // → time.Duration
fmt.Println(duration.String()) // "2h30m0s"
fmt.Println(duration.Seconds()) // 9000.0
⚠️ 注意事项与权衡
- SQL 层 interval 运算受限：改用 bigint 后，无法再在 SQL 中直接使用 interval 函数（如 NOW() + execution_time）。若必须保留此类能力，需额外维护 interval 列（冗余）或在应用层计算后传参。
- 精度一致性：PostgreSQL interval 内部以月/日/秒三元组存储，而 bigint（微秒）仅能精确表示秒及以下单位。若业务涉及月份（如 '1 month'），此方案不适用，需改用字符串存储并自行解析（需谨慎处理闰年、月末等边界）。
- 驱动兼容性：本方案兼容 lib/pq 和 pgx/v4（pgx/v5 默认启用 pgtype，可直接用 pgtype.Interval，但需引入额外依赖）。
✅ 总结
对于绝大多数以“秒级精度”为主、且无需 SQL 层 interval 计算的场景，将 PostgreSQL interval 映射为 bigint 并用 Duration 封装 time.Duration 是最简洁、高效、符合 Go 习惯的方案。它让时间间隔在 Go 中真正“活起来”，同时保持数据库层的轻量与稳定。务必同步更新数据库 schema，并在团队内统一约定时间单位（强烈推荐微秒），即可零成本获得类型安全与工程可维护性的双重提升。
