Hibernate中能否在JPQL类型化查询中使用时间戳字面量？

当然可以在Hibernate的JPQL查询里直接使用时间戳字面量，不过得遵循JPQL的标准语法写法，我结合你的场景给你详细说明：

1. 标准写法：用TIMESTAMP关键字包裹ISO 8601格式字符串 #

JPQL针对Java 8+的LocalDateTime类型，提供了TIMESTAMP关键字来定义字面量，格式要严格遵循ISO 8601规范（比如yyyy-MM-dd'T'HH:mm:ss[.SSSSSSSSS]）。

针对你原来的代码，那个固定的1970-01-01T00:00:00.000000001常量，完全可以替换成字面量，修改后的代码如下：

TypedQuery<TestEntity> query = entityManager
    .createQuery("select t from TestEntity t where greatest(nvl(t.f1, TIMESTAMP '1970-01-01T00:00:00.000000001'), nvl(t.f2, TIMESTAMP '1970-01-01T00:00:00.000000001')) between :date1 and :date2")
    .setParameter("date1", date1)
    .setParameter("date2", date2);

这里的TIMESTAMP '1970-01-01T00:00:00.000000001'会被Hibernate正确解析为对应的LocalDateTime对象，和你之前用setParameter绑定的效果完全一致。

2. 其他时间类型的字面量写法（拓展参考） #

如果涉及其他时间类型，JPQL也有对应的关键字：

• 针对LocalDate：用DATE 'yyyy-MM-dd'，比如DATE '2024-01-01'
• 针对LocalTime：用TIME 'HH:mm:ss'，比如TIME '12:30:00'

3. 字面量 vs 参数绑定的取舍 #

虽然字面量能用，但也要根据场景选择：

• 用字面量的优势：对于固定不变的时间常量（比如你的起始时间），可以减少参数绑定的代码，让JPQL语句更直观。
• 推荐参数绑定的场景：如果时间值是动态生成的、或者你想最大化数据库的查询计划缓存效率、或者遵循通用的安全编码规范（虽然时间字面量注入风险极低，但参数绑定是更稳妥的通用做法），还是建议用原来的参数绑定方式。

注意事项 #

• 格式必须精准：ISO 8601格式不能写错，比如日期和时间之间的T不能丢，纳秒部分如果需要精确到你的例子中的1纳秒，就要写全9位数字。
• 版本兼容性：如果你的Hibernate版本是5.x及以下，需要确保已经引入了hibernate-java8依赖来支持Java 8时间类型；Hibernate 6.x及以上已经内置了对Java 8+时间API的支持，无需额外依赖。

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