Jasper Reports动态调度日期时间范围参数时间丢失问题求助

核心问题原因 #

net.sf.jasperreports.types.date.DateRange类型虽支持DAY/MONTH等动态范围，但默认$X{BETWEEN}会将参数值转为java.sql.Date类型（仅保留日期），导致日志中的时分秒信息在生成SQL时被截断。

实用解决方案（无需多参数hack） #

方案1：手动构造SQL条件，直接调用DateRange的时间方法

绕开$X{BETWEEN}的自动类型转换，直接在SQL中使用DateRange对象的getStart()和getEnd()方法获取完整时间戳：

SELECT * FROM your_table
WHERE
    -- 处理空参数场景（可选）
    ($P{DATE_RANGE_FROM} IS NULL OR timestamp_column >= $P{DATE_RANGE_FROM}.getStart())
    AND ($P{DATE_RANGE_TO} IS NULL OR timestamp_column <= $P{DATE_RANGE_TO}.getEnd())

注意：确保timestamp_column为数据库的时间戳类型（如MySQL的datetime、PostgreSQL的timestamp），Jasper会自动将getStart()/getEnd()返回的Calendar对象绑定为带时分秒的参数值。

方案2：创建计算参数转为Timestamp类型

1. 在报表中新增两个计算参数：
   • 参数名：START_TIMESTAMP，类型：java.sql.Timestamp
     默认表达式：new java.sql.Timestamp($P{DATE_RANGE_FROM}.getStart().getTime())
   • 参数名：END_TIMESTAMP，类型：java.sql.Timestamp
     默认表达式：new java.sql.Timestamp($P{DATE_RANGE_TO}.getEnd().getTime())
2. 在SQL中直接使用这两个参数：

SELECT * FROM your_table
WHERE timestamp_column BETWEEN $P{START_TIMESTAMP} AND $P{END_TIMESTAMP}

调度场景适配 #

针对每日调度需求（如查询前一天完整范围）：

• 设置DATE_RANGE_FROM为DAY-1（自动对应前一天00:00:00）
• 设置DATE_RANGE_TO为DAY-1（自动对应前一天23:59:59）
  通过上述方案生成的SQL会自动包含完整时间，符合预期格式：

... (AND timestamp_column >= "2022-01-22 00:00:00" AND timestamp_column <= "2022-01-22 23:59:59")

避坑提示 #

• 不要使用DAY-2到DAY这类偏移组合，会导致范围边界错误
• 禁止直接硬编码日期时间，保留DateRange的动态输入能力，适配自定义范围查询需求

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