## 時間比較 >[info] 框架內置了常用的時間查詢方法，并且可以自動識別時間字段的類型，所以無論采用什么類型的時間字段，都可以統一使用本章的時間查詢用法。 ### 使用`whereTime`方法 `whereTime`方法提供了日期和時間字段的快捷查詢，示例如下： ~~~ // 大于某個時間 Db::name('user') ->whereTime('birthday', '>=', '1970-10-1') ->select(); // 小于某個時間 Db::name('user') ->whereTime('birthday', '<', '2000-10-1') ->select(); // 時間區間查詢 Db::name('user') ->whereTime('birthday', 'between', ['1970-10-1', '2000-10-1']) ->select(); // 不在某個時間區間 Db::name('user') ->whereTime('birthday', 'not between', ['1970-10-1', '2000-10-1']) ->select(); ~~~ 還可以使用下面的時間表達式進行時間查詢 ~~~ // 查詢兩個小時內的博客 Db::name('blog') ->whereTime('create_time','-2 hours') ->select(); ~~~ ## 查詢某個時間區間 針對時間的區間查詢，系統還提供了`whereBetweenTime/whereNotBetweenTime`快捷方法。 ~~~ // 查詢2017年上半年注冊的用戶 Db::name('user') ->whereBetweenTime('create_time', '2017-01-01', '2017-06-30') ->select(); // 查詢不是2017年上半年注冊的用戶 Db::name('user') ->whereNotBetweenTime('create_time', '2017-01-01', '2017-06-30') ->select(); ~~~ ## 查詢某年 查詢今年注冊的用戶 ``` Db::name('user') ->whereYear('create_time') ->select(); ``` 查詢去年注冊的用戶 ``` Db::name('user') ->whereYear('create_time', 'last year') ->select(); ``` 查詢某一年的數據使用 ~~~ // 查詢2018年注冊的用戶 Db::name('user') ->whereYear('create_time', '2018') ->select(); ~~~ ## 查詢某月 查詢本月注冊的用戶 ~~~ Db::name('user') ->whereMonth('create_time') ->select(); ~~~ 查詢上月注冊用戶 ~~~ Db::name('user') ->whereMonth('create_time','last month') ->select(); ~~~ 查詢2018年6月注冊的用戶 ~~~ Db::name('user') ->whereMonth('create_time', '2018-06') ->select(); ~~~ ## 查詢某周 查詢本周數據 ``` Db::name('user') ->whereWeek('create_time') ->select(); ``` 查詢上周數據 ``` Db::name('user') ->whereWeek('create_time', 'last week') ->select(); ``` 查詢指定某天開始的一周數據 ``` // 查詢2019-1-1到2019-1-7的注冊用戶 Db::name('user') ->whereWeek('create_time', '2019-1-1') ->select(); ``` ## 查詢某天 查詢當天注冊的用戶 ``` Db::name('user') ->whereDay('create_time') ->select(); ``` 查詢昨天注冊的用戶 ``` Db::name('user') ->whereDay('create_time', 'yesterday') ->select(); ``` 查詢某天的數據使用 ~~~ // 查詢2018年6月1日注冊的用戶 Db::name('user') ->whereDay('create_time', '2018-06-01') ->select(); ~~~ ## 時間字段區間比較 可以支持對兩個時間字段的區間比較 ~~~ // 查詢有效期內的活動 Db::name('event') ->whereBetweenTimeField('start_time', 'end_time') ->select(); ~~~ 上面的查詢相當于 ~~~ // 查詢有效期內的活動 Db::name('event') ->whereTime('start_time', '<=', time()) ->whereTime('end_time', '>=', time()) ->select(); ~~~ ## 自定義時間查詢規則 你可以通過在數據庫配置文件中設置`time_query_rule`添加自定義的時間查詢規則， ``` 'time_query_rule' => [ 'hour' => ['1 hour ago', 'now'], ], ```