JPQL查询中Calendar类型搜索规格失效及列表渲染问题

嘿，我来帮你捋捋这两个问题——本质上都是因为你把Calendar类型当成字符串来处理了，咱们一步步解决：

首先看你写的JPQL语句：

(:createdDate is null or tu.taskID.created LIKE CONCAT('%',:createdDate,'%'))

这里的核心错误是：LIKE和CONCAT都是针对字符串的操作，但Calendar是日期时间对象，直接这么写不仅会导致查询逻辑失效，还可能抛出类型转换异常，这就是你第一个问题的根源。

一、修复Calendar类型的搜索规格问题 #

Calendar是日期时间的容器，要做日期查询得用JPA支持的日期比较方式，而不是模糊匹配。根据你的需求（传入createdDate就匹配，否则忽略），分两种常见场景处理：

场景1：精确匹配某一天的所有记录 #

如果你的tu.taskID.created是Calendar类型，对应数据库的DATE/DATETIME字段，可以把传入的Calendar转为当天的起始和结束时间，用BETWEEN来匹配：

// 先处理传入的createdDate，得到当天0点和23:59:59的时间
Calendar startOfDay = (Calendar) createdDate.clone();
startOfDay.set(Calendar.HOUR_OF_DAY, 0);
startOfDay.set(Calendar.MINUTE, 0);
startOfDay.set(Calendar.SECOND, 0);
startOfDay.set(Calendar.MILLISECOND, 0);

Calendar endOfDay = (Calendar) createdDate.clone();
endOfDay.set(Calendar.HOUR_OF_DAY, 23);
endOfDay.set(Calendar.MINUTE, 59);
endOfDay.set(Calendar.SECOND, 59);
endOfDay.set(Calendar.MILLISECOND, 999);

// 修正后的JPQL
String jpql = "SELECT tu FROM YourEntity tu WHERE (:createdDate IS NULL OR tu.taskID.created BETWEEN :startOfDay AND :endOfDay)";

// 设置参数
TypedQuery<YourEntity> query = entityManager.createQuery(jpql, YourEntity.class);
query.setParameter("createdDate", createdDate);
query.setParameter("startOfDay", startOfDay);
query.setParameter("endOfDay", endOfDay);

场景2：匹配日期的部分维度（比如年份、月份） #

如果你是想模糊匹配某一年或某一月的记录，可以用JPA的日期函数（JPA 2.2+支持内置函数，旧版本可以用FUNCTION调用数据库函数）：

// 匹配指定年份的记录（JPA 2.2+直接用YEAR函数）
SELECT tu FROM YourEntity tu WHERE (:createdDate IS NULL OR YEAR(tu.taskID.created) = YEAR(:createdDate))

// 旧版本JPA可以用FUNCTION调用数据库的日期函数（比如MySQL的YEAR）
SELECT tu FROM YourEntity tu WHERE (:createdDate IS NULL OR FUNCTION('YEAR', tu.taskID.created) = FUNCTION('YEAR', :createdDate))

二、修复Calendar类型列表的渲染问题 #

当你查询出包含Calendar的结果后，直接渲染会显示类似java.util.GregorianCalendar[time=1698765432123,...]的杂乱内容，解决方法是把Calendar转换为可读性强的字符串：

方法1：在Java代码中转换（推荐） #

把查询到的Calendar对象转为格式化后的字符串，再传给渲染层：

// Java 8+ 推荐用java.time包转换
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
// 假设你的实体类有getCreated()返回Calendar
String formattedDate = sdf.format(yourEntity.getTaskID().getCreated().getTime());

// 或者转换为LocalDateTime（更现代的方式）
LocalDateTime localDateTime = yourEntity.getTaskID().getCreated()
    .toInstant()
    .atZone(ZoneId.systemDefault())
    .toLocalDateTime();
// 再格式化LocalDateTime
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
String formattedDate = localDateTime.format(formatter);

把格式化后的字符串放到DTO或者视图模型里，再渲染列表就正常了。

方法2：在JPQL查询时直接格式化 #

如果你的JPA实现支持（比如Hibernate），可以在查询时直接返回格式化后的日期字符串：

SELECT tu, FUNCTION('DATE_FORMAT', tu.taskID.created, '%Y-%m-%d %H:%i:%s') AS formattedCreated 
FROM YourEntity tu 
WHERE (:createdDate IS NULL OR tu.taskID.created BETWEEN :startOfDay AND :endOfDay)

这样查询结果里直接包含格式化后的日期字符串，渲染时可以直接使用。

额外建议 #

如果你的项目是Java 8及以上，建议逐步替换Calendar为java.time包下的类（比如LocalDateTime、ZonedDateTime），这些类的API更清晰，JPA对它们的支持也更完善，能避免很多Calendar带来的坑。

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