勾股OA在线文档

时间查询

TP框架内置了常用的时间查询方法,并且可以自动识别时间字段的类型,所以无论采用什么类型的时间字段,都可以统一使用时间查询用法。

1、使用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();

2、还可以使用下面的时间表达式进行时间查询

// 查询两个小时内的博客
Db::name('blog')->whereTime('create_time','-2 hours')->select();

3、查询某个时间区间
针对时间的区间查询,系统还提供了whereBetweenTime/whereNotBetweenTime快捷方法。

// 查询2021年上半年注册的用户
Db::name('user')->whereBetweenTime('create_time', '2021-01-01', '2021-06-30')->select();
// 查询不是2021年上半年注册的用户
Db::name('user')->whereNotBetweenTime('create_time', '2021-01-01', '2021-06-30')->select();

3、查询某年

//查询今年注册的用户
Db::name('user')->whereYear('create_time')->select();

//查询去年注册的用户
Db::name('user')->whereYear('create_time', 'last year')->select();

4、查询某一年的数据使用

// 查询2021年注册的用户
Db::name('user')->whereYear('create_time', '2021')->select();

5、查询某月

//查询本月注册的用户
Db::name('user')->whereMonth('create_time')->select();

//查询上月注册用户
Db::name('user')->whereMonth('create_time','last month')->select();

//查询2021年6月注册的用户
Db::name('user')->whereMonth('create_time', '2021-06')->select();

6、查询某周

//查询本周数据
Db::name('user')->whereWeek('create_time')->select();

//查询上周数据
Db::name('user')->whereWeek('create_time', 'last week')->select();

7、查询指定某天开始的一周数据

// 查询2019-1-1到2019-1-7的注册用户
Db::name('user')->whereWeek('create_time', '2019-1-1')->select();

8、查询某天

//查询当天注册的用户
Db::name('user')->whereDay('create_time')->select();

//查询当天录入的合同
Db::name('Contract')->whereDay('create_time')->where('delete_time','=',0)->select();

//查询昨天注册的用户
Db::name('user')->whereDay('create_time', 'yesterday')->select();

9、查询某天的数据使用

// 查询2018年6月1日注册的用户
Db::name('user')->whereDay('create_time', '2018-06-01')->select();

10、可以支持对两个时间字段的区间比较

// 查询有效期内的活动
Db::name('event')->whereBetweenTimeField('start_time', 'end_time')->select();

// 查询有效期内的活动
Db::name('event')->whereTime('start_time', '<=', time())->whereTime('end_time', '>=', time())->select();

11、自定义时间查询规则
可以通过在数据库配置文件中设置time_query_rule添加自定义的时间查询规则,

'time_query_rule'    =>    [
    'hour'    =>    ['1 hour ago', 'now'],
],