跳到主要内容

API 数据集：时间查询

概述​

当报表需要按“日期/时间”进行筛选时，可以在 API 数据集中配置时间型查询条件和参数，由前台控件传参到API接口完成过滤。

本篇说明：

  • 报表如何配置时间查询控件和参数
  • API数据集如何接收并解析日期参数（字符串）
  • 与范围查询的区别与配合

一、报表配置步骤​

1. 配置字段为“日期类型”，勾选“查询”，选择查询模式​

  • 单条件查询：单个日期
  • 范围查询：开始/结束日期

2. API接口地址配置日期参数​

将日期参数拼接到 API 地址，并在报表中配置对应参数后生效

3. 前台传参格式​

前台将日期字控件的值，以字符串格式传给API接口，默认格式为：yyyy-MM-dd

更多日期格式设置：时间控件格式设置

接受示例代码：

SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd");
Date parse = dateFormat.parse(riqi);
SimpleDateFormat dateFormat1 = new SimpleDateFormat("yyyy年MM月dd日");
format = dateFormat1.format(parse);

4. 点击查询​

二、与范围查询的配合​

范围查询的参数命名为：

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