Go time.Time存入PostgreSQL出现时间偏移及早期日期异常问题

问题现象 #

将Go的time.Time{}（零值）存入PostgreSQL的timestamp with time zone字段后，读取出来的时间出现异常偏移；1900年左右的日期可正常存储，但更早的日期存储结果不稳定。

复现代码 #

type TimeTest struct {
    Time time.Time
}
func (b *TimeTest) TableName() string {
    return "timetest"
}

func (repo RepoBe) TimeDemo() (timeBefore, timeAfter *time.Time, err error) {
    t := &TimeTest{
        Time: time.Time{}, // Zero time.
    }
    repo.Logr.Debug("before DB", zap.Time("time", t.Time))
    if err := repo.DB.Create(&t).Error; err != nil {
        return nil, nil, err
    }
    var u *TimeTest
    if err := repo.DB.First(&u).Error; err != nil {
        return nil, nil, err
    }
    repo.Logr.Debug("after DB", zap.Time("time", u.Time))

    return &t.Time, &u.Time, nil
}

输出结果 #

{"level":"DEBUG","timestamp":"2023-11-09T10:39:23.273+0100","operation":"before DB","time":"0001-01-01T00:00:00.000Z"}
{"level":"DEBUG","timestamp":"2023-11-09T10:39:23.303+0100","operation":"after DB","time":"0001-01-01T00:57:44.000+0057"}

PostgreSQL时区设置 #

postgres=# show timezone;
 TimeZone
-----------
 Europe/Prague
(1 row)

表结构 #

SET statement_timeout = 0;
SET lock_timeout = 0;
SET idle_in_transaction_session_timeout = 0;
SET client_encoding = 'UTF8';
SET standard_conforming_strings = on;
SELECT pg_catalog.set_config('search_path', '', false);
SET check_function_bodies = false;
SET xmloption = content;
SET client_min_messages = warning;
SET row_security = off;

SET default_tablespace = '';

SET default_table_access_method = heap;
CREATE TABLE public.timetest (
    "time" timestamp with time zone
);

ALTER TABLE public.timetest OWNER TO postgres;

问题原因 #

1. 旧时区规则差异：PostgreSQL处理1900年之前的日期时，会采用对应时区的历史规则。以Europe/Prague为例，19世纪之前该地区使用本地太阳时，偏移为+00:57:44，而非现代的+01:00。Go的time.Time零值是0001-01-01 UTC，存入PG时会被转换为数据库时区对应的历史时间，读取后就会显示异常偏移。
2. 时区数据不一致：极早日期的时区规则在不同系统（Go、PostgreSQL）的时区数据库中可能存在差异，导致存储和读取的结果不稳定。

解决方案 #

1. 统一使用UTC时区存储 #

在PostgreSQL连接DSN中添加timezone=UTC参数，强制所有时间以UTC存储和转换，避免历史时区规则的影响：

postgres://user:password@host:port/dbname?sslmode=require&timezone=UTC

或者在代码中手动将时间转换为UTC后再存入：

t.Time = time.Time{}.UTC()

2. 改用不带时区的时间类型 #

修改表结构，将字段类型改为timestamp without time zone，这样PostgreSQL不会进行时区转换，直接存储原始时间值。注意应用层需统一处理时区，避免跨时区场景下的时间混乱：

ALTER TABLE public.timetest ALTER COLUMN "time" TYPE timestamp without time zone;

3. 限制日期范围 #

如果业务不需要处理1900年之前的日期，在应用层添加日期校验，避免触发旧时区规则问题：

minValidTime := time.Date(1900, 1, 1, 0, 0, 0, 0, time.UTC)
if t.Time.Before(minValidTime) {
    // 抛出错误或处理非法日期
}

内容的提问来源于stack exchange，提问作者Adam