用业务时区把起始日和结束日的次日分别转换为 instant,再用 timestamp >= start 且 timestamp 查询。这样会包含结束日内的所有时间点,跨月也由日期 api 处理。

构建左闭右开的时间窗口
处理日期范围查询的核心在于确定边界的包含关系。对于开始日期,我们通常希望包含该天的所有时刻,因此取其当天的起始时间(00:00:00)。对于结束日期,如果业务要求包含该天的所有数据,直接使用该天的 23:59:59.999 往往是不安全的,因为毫秒级的精度丢失或时区偏移可能导致漏查。正确的做法是将结束日期向后推一天,并取那一天的起始时间作为排他性终点。这样,任何落在结束日期内的时间点,都严格小于这个排他性终点。
import java.time.LocalDate;
import java.time.ZoneId;
import java.time.Instant;
public class DateRangeBuilder {
public static void main(String[] args) {
// 假设业务时区为 Asia/Shanghai
ZoneId zone = ZoneId.of("Asia/Shanghai");
LocalDate startDay = LocalDate.of(2026, 11, 1);
LocalDate endDay = LocalDate.of(2026, 11, 3);
// 起点:开始日期的当天零点
Instant startInstant = startDay.atStartOfDay(zone).toInstant();
// 终点:结束日期的次日零点(排他)
Instant endInstant = endDay.plusDays(1).atStartOfDay(zone).toInstant();
System.out.println("Start: " + startInstant);
System.out.println("End (Exclusive): " + endInstant);
}
}验证正常与失败分支的数据过滤
有了确定的 Instant 范围后,我们需要验证不同时间点是否被正确包含。这里模拟一个常见的场景:检查某个具体事件发生的时间戳是否落在目标日期区间内。我们将测试三个关键节点:开始日期的任意时刻、结束日期的最后一刻,以及结束日期之后的第一刻。通过比较操作符,可以清晰地看到左闭右开区间的行为特征。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
import java.time.LocalDate;
import java.time.ZoneId;
import java.time.Instant;
public class RangeValidator {
public static void main(String[] args) {
ZoneId zone = ZoneId.of("Asia/Shanghai");
LocalDate startDay = LocalDate.of(2026, 11, 1);
LocalDate endDay = LocalDate.of(2026, 11, 3);
// 构建标准区间
Instant start = startDay.atStartOfDay(zone).toInstant();
Instant end = endDay.plusDays(1).atStartOfDay(zone).toInstant();
// 测试用例 1:结束日期的最后一秒(应包含)
Instant testInclude = end.minusSeconds(1);
boolean isIncluded = !testInclude.isBefore(start) && testInclude.isBefore(end);
System.out.println("End day last second included: " + isIncluded); // true
// 测试用例 2:结束日期的下一天零点(不应包含)
Instant testExclude = end; // 即 11月4日 00:00:00
boolean isExcluded = !testExclude.isBefore(start) && testExclude.isBefore(end);
System.out.println("Next day start excluded: " + isExcluded); // false
// 测试用例 3:开始日期的前一天(不应包含)
Instant testBefore = start.minusSeconds(1);
boolean isBefore = !testBefore.isBefore(start) && testBefore.isBefore(end);
System.out.println("Day before start excluded: " + isBefore); // false
}
}
立即学习“Java免费学习笔记(深入)”;
映射到 SQL 查询条件与数据库交互
在将 Java 逻辑转换为 SQL 查询时,保持语义的一致性至关重要。由于 Java 端已经计算出了包含结束当天的 Instant 范围,SQL 语句应当直接使用 >= 和
-- 假设表名为 events,时间列为 event_time -- 参数 :start_instant 对应 Java 中的 start Instant -- 参数 :end_instant 对应 Java 中的 end Instant (排他) SELECT * FROM events WHERE event_time >= :start_instant AND event_time < :end_instant; -- 下面使用 UTC 表示边界,参数类型需与时间列一致: -- :start_instant = '2026-10-31T16:00:00Z' -- :end_instant = '2026-11-03T16:00:00Z' -- 结果将包含 11月1日 至 11月3日 23:59:59.999... 的所有记录

















