時間查詢（查詢建構器8）

時間比較

框架內建了常用的時間查詢方法，並且可以自動識別時間欄位的類型，所以無論採用什麼類型的時間字段，都可以統一使用本章的時間查詢用法。

使用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'],
]