TP5.1 时间查询完全教程

官方文档：https://www.kancloud.cn/manual/thinkphp5_1/354029

一、时间比较 - 使用where方法

where方法支持时间比较，例如：

// 大于某个时间
where('create_time', '> time', '2016-1-1');

// 小于某个时间
where('create_time', '<= time', '2016-1-1');

// 时间区间查询
where('create_time', 'between time', ['2015-1-1', '2016-1-1']);

第三个参数可以传入任何有效的时间表达式，会自动识别你的时间字段类型，支持的时间类型包括timestamps、datetime、date和int。

二、使用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('user')
    ->whereTime('birthday', '1970-10-1')
    ->select();

// 时间区间查询
Db::name('user')
    ->whereTime('birthday', ['1970-10-1', '2000-10-1'])
    ->select();

三、whereBetweenTime方法

针对时间的区间查询，系统还提供了一个whereBetweenTime快速方法：

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

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

没有指定结束时间的话，表示查询当天。

四、查询某天

有两种方式查询某一天的数据：

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

// 或者使用whereTime方法
Db::name('user')
    ->whereTime('create_time',['2017-06-01', '2017-06-02'])
    ->select();

五、时间表达式

还提供了更方便的时间表达式查询，例如：

// 获取今天的博客
Db::name('blog')->whereTime('create_time', 'today')->select();

// 获取昨天的博客
Db::name('blog')->whereTime('create_time', 'yesterday')->select();

// 获取本周的博客
Db::name('blog')->whereTime('create_time', 'week')->select();

// 获取上周的博客
Db::name('blog')->whereTime('create_time', 'last week')->select();

// 获取本月的博客
Db::name('blog')->whereTime('create_time', 'month')->select();

// 获取上月的博客
Db::name('blog')->whereTime('create_time', 'last month')->select();

// 获取今年的博客
Db::name('blog')->whereTime('create_time', 'year')->select();

// 获取去年的博客
Db::name('blog')->whereTime('create_time', 'last year')->select();

简化写法：

// 获取今天的博客 - 简化写法 d
Db::name('blog')->whereTime('create_time', 'd')->select();

// 获取本周的博客 - 简化写法 w
Db::name('blog')->whereTime('create_time', 'w')->select();

// 获取本月的博客 - 简化写法 m
Db::name('blog')->whereTime('create_time', 'm')->select();

// 获取今年的博客 - 简化写法 y
Db::name('blog')->whereTime('create_time', 'y')->select();

其他时间表达式：

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

六、多个时间字段区间比较（V5.1.17+）

V5.1.17+版本开始，可以支持对两个时间字段的区间比较：

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

上面的查询相当于：

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

总结

TP5.1的时间查询功能非常强大，可以方便快捷地进行各种时间范围查询，包括：

• 基本的时间大于/小于比较
• 时间区间查询（between）
• 快捷时间表达式（today、yesterday、week、month、year等）
• 简写形式（d、w、m、y）
• 相对时间查询（-2 hours等）
• 双时间字段区间比较

掌握这些时间查询方法，可以大大简化日常开发中的时间筛选需求。