php⽇期筛选，添加时间段筛选·DolphinPHP1.5.0完全开发⼿册-
基于Think。。。
## addTimeFilter('字段名' [,'开始⽇期和结束⽇期', '开始⽇期和结束⽇期的提⽰'])
| 版本 | 新增功能 |
| --- | --- |
| 1.0.6 | ⽀持⾃定义开始⽇期和结束⽇期，以及⽂本框提⽰信息 |
php手册官方中文版
可以对某个时间字段进⾏时间段筛选，⽐如：
~~~
// 使⽤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();
~~~

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。