如何在BIRT报表中基于报表参数自动计算月份起止日期

需求说明 #

• 已在BIRT报表中配置startdate和enddate两个日期参数
• 自动补全规则：
  • 输入起始日期时，自动计算该月份的最后一天（精确到23:59:59.998），示例：输入2024-03-01 00:00:00.000，自动生成2024-03-31 23:59:59.998
  • 输入结束日期时，自动计算该月份的第一天（00:00:00.000）

问题描述 #

尝试了一段用于输入enddate时自动计算startdate的脚本，但未生效，代码如下：

if(params["startdate"].value == null && params["enddate"].value)
{
endDate = MXReportSqlFormat.getEndDayTimestampFunction(params["endDate"])
startDate = new Date(endDate.getFullYear(), endDate.getMonth(), 1)
where  += " and a.actualdate >= " + startDate
}

问题分析与修正方案 #

原代码问题点 #

1. 参数名大小写不匹配：定义的参数是enddate，但代码中用了params["endDate"]，BIRT参数名区分大小写
2. 日期拼接格式错误：直接将Date对象拼入SQL会导致格式异常，需转成数据库可识别的字符串格式
3. 逻辑判断不严谨：params["enddate"].value未明确判断非空，应改为params["enddate"].value != null
4. 逻辑方向错误：应直接给参数赋值，而非仅拼接WHERE条件（若脚本用于参数补全）

修正后的完整脚本 #

// 场景1：仅输入enddate，自动补全startdate
if (params["startdate"].value == null && params["enddate"].value != null) {
    var endDate = params["enddate"].value;
    // 计算当月第一天
    var startDate = new Date(endDate.getFullYear(), endDate.getMonth(), 1);
    // 给startdate参数赋值
    params["startdate"].value = startDate;

    // 若需拼接SQL条件，转成数据库兼容的时间格式
    var startDateStr = MXReportSqlFormat.formatDate(startDate, "yyyy-MM-dd HH:mm:ss.SSS");
    where += " and a.actualdate >= TIMESTAMP '" + startDateStr + "'";
}

// 场景2：仅输入startdate，自动补全enddate
if (params["enddate"].value == null && params["startdate"].value != null) {
    var startDate = params["startdate"].value;
    // 计算当月最后一天的23:59:59.998
    var endDate = new Date(startDate.getFullYear(), startDate.getMonth() + 1, 0, 23, 59, 59, 998);
    params["enddate"].value = endDate;

    var endDateStr = MXReportSqlFormat.formatDate(endDate, "yyyy-MM-dd HH:mm:ss.SSS");
    where += " and a.actualdate <= TIMESTAMP '" + endDateStr + "'";
}

注意事项 #

• 脚本需放在报表的beforeOpen事件中，或参数的默认值脚本区域
• 不同数据库的时间戳语法不同，例如Oracle需用TO_TIMESTAMP('" + startDateStr + "', 'YYYY-MM-DD HH24:MI:SS.FF3')
• 需测试边界场景：两个参数都输入、都不输入的情况，避免逻辑冲突

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