Photo by Lorem Ipsum
656 words
3 minutes
Java日期精度问题与SQL Server日期范围判定方法
AI 智能总结
Java日期精度问题与SQL Server日期范围判定方法
日常开发中，Java日期精度丢失搭配SQL Server日期类型精度不匹配，极易出现查询数据缺失、匹配异常等隐蔽Bug。本文精简梳理核心问题，搭配可直接落地的代码与SQL方案。
一、Java 日期类精度问题
1. 核心问题
Java8 之前的 java.util.Date 仅支持毫秒级精度；而 Java8 新时间 API LocalDateTime 支持纳秒级精度。
SQL Server 主流旧类型 datetime 仅支持3毫秒步进（0/3/7），无法精准存储整毫秒时间，Java 高精度时间入库后会被自动舍入，导致前后时间不一致、查询匹配失效。
2. 问题复现代码
import java.time.LocalDateTime;import java.time.format.DateTimeFormatter;
public class DatePrecisionDemo { public static void main(String[] args) { // LocalDateTime 纳秒精度 LocalDateTime now = LocalDateTime.now(); System.out.println("原始高精度时间：" + now);
// 格式化保留7位毫秒 String formatTime = now.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSS")); System.out.println("格式化毫秒时间：" + formatTime); }}现象：Java 携带的毫秒、微秒数据，存入 datetime 字段后被截断舍入，查询时时间不匹配，数据查不到。
3. Java 端解决方案
统一截断时间精度，适配数据库存储规则，避免精度溢出：
// 截断至毫秒级，适配SQL ServerLocalDateTime dbTime = LocalDateTime.now().withNano(0);二、SQL Server 日期范围判断陷阱
1. 类型精度差异
datetime：精度 0.003 秒，秒小数仅存 000/003/007datetime2：默认7位小数（100纳秒精度），完美适配Java高精度时间
2. 错误写法（高频Bug）
很多人使用闭区间 BETWEEN 或截止时间 23:59:59.999 查询：
-- 错误：datetime 会将 23:59:59.999 舍入为次日 00:00:00.000，丢失当日末尾数据SELECT * FROM tableWHERE create_time BETWEEN '2026-08-01 00:00:00' AND '2026-08-01 23:59:59.999'3. 最优规范写法
开闭区间查询，兼容所有日期类型，无精度丢失、无数据遗漏：
-- 正确：起始闭区间、结束开区间，覆盖当日所有时间SELECT * FROM tableWHERE create_time >= '2026-08-01 00:00:00'AND create_time < '2026-08-02 00:00:00'三、前后端统一最佳实践
- 数据库字段：废弃
datetime，统一使用datetime2，兼容Java纳秒精度，无舍入误差。 - Java代码：入库前截断时间纳秒，统一毫秒精度，避免冗余精度不匹配。
- 查询语法：固定左闭右开区间，禁止使用
BETWEEN和当日最后一秒截止写法。
总结
所有日期查询异常，根源基本都是Java与数据库时间精度不匹配 + 区间写法不规范。只要统一 datetime2 字段 + 毫秒级时间截断 + 开闭区间查询，即可彻底解决此类问题。
Java日期精度问题与SQL Server日期范围判定方法
https://fuwari.vercel.app/posts/java-date-problem/