temporalqueries 是只读工具类，提供预置静态 temporalquery 实例但不支持扩展；自定义查询需直接实现 temporalquery 接口并传入 query() 方法。
TemporalQueries 是工具类，不是扩展点
TemporalQueries 是 Java 8+ 中一个 只读的工具类，它内部预置了若干静态 TemporalQuery 实例（如 Chronology、ZoneId、Precision），但不提供注册或覆盖机制。你无法通过它“添加”自定义查询逻辑，也不能修改它的行为。
常见误解是把它当成类似 Spring 的扩展容器——实际它只是个装着常用查询器的“工具箱”，所有字段都是 public static final，且构造函数私有，不可继承或增强。
想实现自定义时间查询，直接 new TemporalQuery
真正可操作的方式是：**自己实现 TemporalQuery<t></t> 函数式接口**，然后传给 temporal.query(...) 方法。Java 不强制你用 TemporalQueries 里的现成实例。
例如，要查某个 LocalDateTime 所属的“本月第几周”（按周一为周首）：
TemporalQuery<integer> weekOfMonth = temporal -> {
LocalDate date = LocalDate.from(temporal);
return date.get(IsoFields.WEEK_OF_MONTH);
};</integer>
weekOfMonth 就是一个合法的自定义查询器，可直接使用：
LocalDateTime dt = LocalDateTime.of(2024, 5, 15, 10, 0); int result = dt.query(weekOfMonth); // 返回 3（5月15日是5月第3周）
- 注意：必须确保入参
temporal支持所需字段，否则会抛DateTimeException - 若需兼容多种类型（
LocalDateTime、ZonedDateTime等），建议用TemporalAccessor做参数，再调LocalDate.from(...)或ZonedDateTime.from(...)转换 - 不要在 query 实现里做耗时计算（如网络请求、文件读取），因为
query()设计为轻量、无副作用
为什么不能复用 TemporalQueries 的静态字段做扩展
所有 TemporalQueries.xxx 字段（如 TemporalQueries.chronology）本质是匿名内部类或 lambda 表达式的实例，它们的逻辑被硬编码在 JDK 源码里，且没有开放 SPI 或配置入口。
试图通过反射篡改这些静态字段不仅违反模块封装（JDK 9+ 模块系统会阻止），还会导致：
- 不同 JVM 版本行为不一致（比如
TemporalQueries.precision在LocalTime和Instant上返回值类型不同） - 破坏线程安全（这些实例虽不可变，但若强行替换，可能引发可见性问题）
- 单元测试难 Mock——因为它是 static final，主流 Mock 工具（Mockito 4+）默认不支持 mock 静态方法/字段
复杂场景下容易忽略的类型兼容性
自定义 TemporalQuery 最常踩的坑，是没考虑 TemporalAccessor 的字段完备性。比如下面这个错误写法：
TemporalQuery<zoneid> zoneQuery = temporal -> ((ZonedDateTime) temporal).getZone();</zoneid>
这段代码在传入 LocalDateTime 时会直接 ClassCastException，而正确的做法是：
TemporalQuery<zoneid> zoneQuery = temporal -> {
if (temporal instanceof ZonedDateTime zdt) return zdt.getZone();
if (temporal instanceof OffsetDateTime odt) return odt.getOffset();
throw new DateTimeException("Unsupported temporal type: " + temporal.getClass());
};</zoneid>
更稳妥的方式是优先使用 temporal.query(TemporalQueries.zoneId) 先尝试标准查询，失败后再 fallback 到自定义逻辑——毕竟 TemporalQueries.zoneId 本身已做了类型判断和降级处理。
真正需要自定义查询的，往往是业务语义层面的派生值（如“是否为节假日”“所属财年季度”），这类逻辑本就不该塞进 JDK 的基础设施层。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
