php 日期筛选,添加时间段筛选 · DolphinPHP1.5.0完全开发手册-基于ThinkPHP5.1.41LTS的快速开发框架 · 看云...

## addTimeFilter('字段名' [,'开始日期和结束日期', '开始日期和结束日期的提示'])

| 版本 | 新增功能 |

| --- | --- |

| 1.0.6 | 支持自定义开始日期和结束日期，以及文本框提示信息 |

可以对某个时间字段进行时间段筛选，比如：

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addTimeFilter('create_time') // 添加时间段筛选

->fetch();

~~~

以上表示添加`create_time`字段的范围筛选，数据表格上方会出现时间段输入框。


>[danger]注意：目前只支持一个字段，即addTimeFilter方法只能用一次，不可连续调用。

### 自定义开始日期和结束日期

>[info] 从1.0.6版本开始，可以自定义开始日期和结束日期，自定义文本框提示信息，默认是“开始日期”和“结束日期”。

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addTimeFilter('create_time', '2017-01-01,2017-02-01') // 添加时间段筛选

->fetch();

~~~


也可以使用数组

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addTimeFilter('create_time', ['2017-01-01', '2017-02-01']) // 添加时间段筛选

->fetch();

~~~

>[info] 如果只写一个日期，则开始日期和结束日期相同

这样仅显示默认开始日期和结束日期，还需要配合$map查询默认的数据。

~~~

$map = $this->getMap();

if (!isset($map['create_time'])) {

$map['create_time'] = ['between time', ['2017-01-01 00:00:00', '2017-02-01 23:59:59']]

}

$data_list = Db::name('admin_user')->where($map)->paginate();

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addTimeFilter('create_time', '2017-01-01,2017-02-01') // 添加时间段筛选

->setRowList($data_list)

->fetch();

~~~

### 自定义文本框提示信息

>[info] 从1.0.6版本开始，可以自定义文本框提示信息，默认是“开始日期”和“结束日期”。

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addTimeFilter('create_time', '', '开始时间,结束时间')

->fetch();

~~~

>[info] 如果只写一个提示，则开始日期和结束日期相同的提示相同。

也可以使用数组

~~~

// 使用ZBuilder构建数据表格

return ZBuilder::make('table')

->addTimeFilter('create_time', '', ['开始时间', '结束时间'])

->fetch();

~~~