公元前日期在数据库中的处理是一个被长期忽视的难题。Java 的 ISO 8601 年份表示法与数据库的日期系统存在根本性差异，导致跨系统传递公元前日期时经常出现"偏移一年"或"偏移一天"的诡异 Bug。
dbVisitor 6.7.0 新增了 JulianDayTypeHandler 和 PgDateTypeHandler 两个处理器，分别从"跨库通用"和"PostgreSQL 原生"两个角度彻底解决这个问题。
问题根源：年份表示法的歧义
Java 的 LocalDate 使用 ISO 8601 标准，Year 0 表示公元前 1 年：
| Java Year | 含义 | PostgreSQL 表示 |
|---|---|---|
| 1 | 公元 1 年 (1 AD) | 0001-01-01 |
| 0 | 公元前 1 年 (1 BC) | 0001-01-01 BC |
| -1 | 公元前 2 年 (2 BC) | 0002-01-01 BC |
| -99 | 公元前 100 年 (100 BC) | 0100-01-01 BC |
转换公式：BC 年份 = |Java Year| + 1
而 java.sql.Date 底层使用 Proleptic Gregorian Calendar，这会在日期转换时引发偏移。不同 JDBC 驱动对公元前日期的处理也各不相同，有些甚至直接抛异常。
方案一：JulianDayTypeHandler --- 跨数据库通用方案
儒略日数（Julian Day Number）是天文学中使用的连续日期计数系统，从公元前 4713 年 1 月 1 日开始，不存在任何历法歧义。
原理 ：将 LocalDate 转换为一个 BIGINT 整数存入数据库，读取时逆向还原。
java
// 存储：公元前 100 年 → 儒略日数 1684534
LocalDate bcDate = LocalDate.of(-99, 1, 1);
Map<String, Object> params = new HashMap<>();
params.put("id", 1);
params.put("date", bcDate);
jdbcTemplate.executeUpdate(
"INSERT INTO events (id, julian_day) VALUES (#{id}, #{date, typeHandler=net.hasor.dbvisitor.types.handler.time.JulianDayTypeHandler})",
params
);
// 读取：儒略日数 1684534 → 公元前 100 年
LocalDate loaded = jdbcTemplate.queryForObject(
"SELECT julian_day FROM events WHERE id = ?",
new Object[] { 1 },
(rs, rowNum) -> new JulianDayTypeHandler().getResult(rs, "julian_day")
);
assertEquals(bcDate, loaded); // ✔ 通过
assertEquals(-99, loaded.getYear()); // ✔ Year -99 = 100 BC算法核心（Richards 2012）：
java
// LocalDate → Julian Day Number
int a = (14 - month) / 12;
int y2 = year + 4800 - a;
int m2 = month + 12 * a - 3;
long jdn = day + (153 * m2 + 2) / 5 + 365 * y2 + y2 / 4 - y2 / 100 + y2 / 400 - 32045;适用场景：
- 需要跨数据库（MySQL、PostgreSQL、Oracle、SQLite 等）保持一致性
- 历史学、天文学数据
- 数据库类型仅需
BIGINT，不依赖原生 DATE
方案二：PgDateTypeHandler --- PostgreSQL 原生方案
如果你的项目锁定 PostgreSQL，可以利用其原生的 BC 后缀格式，直接使用 DATE 类型存储。
java
LocalDate bcDate = LocalDate.of(-99, 1, 1);
Map<String, Object> params = new HashMap<>();
params.put("id", 1);
params.put("date", bcDate);
jdbcTemplate.executeUpdate(
"INSERT INTO events (id, event_date) VALUES (#{id}, #{date, typeHandler=net.hasor.dbvisitor.types.handler.time.PgDateTypeHandler})",
params
);
// 数据库中存储为: 0100-01-01 BC
// 读取时自动转换回 LocalDate.of(-99, 1, 1)优势：
- 使用数据库原生
DATE类型，支持 SQL 中直接查询和比较（如WHERE event_date < '0500-01-01 BC'） - 无需额外的类型转换层
注意事项：
- ISO 8601 的闰年规则与 PostgreSQL BC 的闰年规则不同。Java 中
Year -4是闰年（ISO 闰年），但转换后5 BC在 PostgreSQL 中不是闰年。 - 仅适用于 PostgreSQL
方案对比
| 维度 | JulianDayTypeHandler | PgDateTypeHandler |
|---|---|---|
| 数据库支持 | 所有（存为 BIGINT） | 仅 PostgreSQL |
| 存储类型 | BIGINT |
DATE |
| SQL 中日期比较 | 数值比较（可行但不直观） | 原生日期比较 |
| 精度 | 天级（无时间） | 天级（无时间） |
| 闰年兼容 | 无歧义（纯数值） | 需注意 BC 闰年差异 |
| 迁移成本 | 低（通用整数列） | 中（依赖 PG） |
选择建议 ：跨库项目或对一致性要求高的场景用 JulianDayTypeHandler；PostgreSQL 专属项目且需要在 SQL 中操作日期的场景用 PgDateTypeHandler。