框架内置了常用的时间查询方法,并且可以自动识别时间字段的类型,所以无论采用什么类型的时间字段,都可以统一使用本章的时间查询用法。
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'],],