## 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(); ~~~