跳到主要内容

API 数据集：时间范围查询

概述​

API 数据集支持“范围查询”模式，常用于选取“开始日期”和“结束日期”等区间条件。

本篇说明：

  • 报表范围查询的配置方法
  • 参数命名规则：字段名_begin / 字段名_end
  • API接收与解析示例（Java）

一、报表配置​

选择类型：日期类型
查询状态：勾选
查询模式：范围查询

二、预览与使用​

需要选择开始日期和结束日期，点击查询即可

三、参数命名与后台接收（Java 示例）​

范围查询的参数命名规则：

  • 开始参数：字段名_begin
  • 结束参数：字段名_end

示例：字段名为 riqi，则为 riqi_begin 与 riqi_end。

示例代码​

    @GetMapping("/getUserMsg")
    public JSONObject getUserMsg(@RequestParam(name = "riqi_begin",required = false) String riqi_begin,
                                 @RequestParam(name = "riqi_end",required = false) String riqi_end) {
        JSONObject jsonObject = new JSONObject();
        // TODO 自定义业务
        return jsonObject;
    }

最终参数接收效果如下：

四、查询条件如何接收​

详见 api数据集配置查询条件后台接收参数