whereTime方法

whereTime方法

1、功能：专用于日期时间型字段的查询

whereTime可完全用where方法代替

2、源码：/thinkphp/libray/think/db/Query.php

/** * 查询日期或者时间 * @access public * @param string $field 日期字段名 * @param string $op 比较运算符或者表达式 * @param string|array $range 比较范围 * @return $this */ public function whereTime($field, $op, $range = null) { if (is_null($range)) { // 使用日期表达式 $date = getdate(); switch (strtolower($op)) { case 'today': case 'd': $range = 'today'; break; case 'week': case 'w': $range = 'this week 00:00:00'; break; case 'month': case 'm': $range = mktime(0, 0, 0, $date['mon'], 1, $date['year']); break; case 'year': case 'y': $range = mktime(0, 0, 0, 1, 1, $date['year']); break; case 'yesterday': $range = ['yesterday', 'today']; break; case 'last week': $range = ['last week 00:00:00', 'this week 00:00:00']; break; case 'last month': $range = [date('y-m-01', strtotime('-1 month')), mktime(0, 0, 0, $date['mon'], 1, $date['year'])]; break; case 'last year': $range = [mktime(0, 0, 0, 1, 1, $date['year'] - 1), mktime(0, 0, 0, 1, 1, $date['year'])]; break; } $op = is_array($range) ? 'between' : '>'; } $this->where($field, strtolower($op) . ' time', $range); return $this; }

源码分析：

1. 首先获取到当前时间 ：getDate(),获取到一个时间数组：

array(11) { ["seconds"] => int(46) ["minutes"] => int(59) ["hours"] => int(16) ["mday"] => int(13) ["wday"] => int(0) ["mon"] => int(11) ["year"] => int(2016) ["yday"] => int(317) ["weekday"] => string(6) "Sunday" ["month"] => string(8) "November" [0] => int(1479027586) }

1. 此时，将该方法的第三个参数：range视为时间表达式，根据它的值进行判断，从$date数组中取中对应的数据：

   • 例如：$op='year' 或 'y'，表示‘年’,则取出date['year']，赋值第三个参数：$range;

2. mktime(小时,分钟,秒, 月,日,年)，返回时间戳，strtotime()将日期型字符串转时间戳；

3. 如果$range是数组，则把操作符$op变更成：between,进行区间查询

4. 最后仍是调用 where 方法完成查询

3、基本语法：

与上节介绍的where非常相似，可视为where中专门针对日期字段查询的特例。语法上看，可以简单记为：查询表达式中的time，做为方法名单词第二部分即可。即将where中查询表达式中的time，移到方法名where后面做后缀，即whereTime 。

Db::table('表名') -> field('字段列表') ->whereTime('日期类型字段','条件表达式', '日期格式') ->select();

4、实例演示：

我们仍以上节课的例子，演示比较查询和区间查询

1.任务1：查询tp5_staff表中2015年1月1日以后入职的员工信息

• Index.php 控制器代码：

 field('id,name,hiredate') ->whereTime('hiredate','>', '2015-01-01') ->select(); dump($result); } }

• 查询结果：

array(5) { [0] => array(3) { ["id"] => int(1006) ["name"] => string(9) "西门庆" ["hiredate"] => string(10) "2015-12-25" } [1] => array(3) { ["id"] => int(1007) ["name"] => string(9) "潘金莲" ["hiredate"] => string(10) "2016-03-14" } [2] => array(3) { ["id"] => int(1008) ["name"] => string(6) "宋江" ["hiredate"] => string(10) "2015-12-31" } [3] => array(3) { ["id"] => int(1023) ["name"] => string(9) "段王爷" ["hiredate"] => string(10) "2015-12-31" } [4] => array(3) { ["id"] => int(1028) ["name"] => string(6) "方方" ["hiredate"] => string(10) "2015-12-31" } }

• 对应的SQL语句：

SELECT `id`,`name`,`hiredate` FROM `tp5_staff` WHERE `hiredate` > '2015-01-01'

2. 任务2：查询tp5_staff表中2015年1月1日到2016年1月1日之间入职的员工

• Index.php 控制器源码

 field('id,name,hiredate') ->whereTime('hiredate','between', ['2015-01-01','2016-01-01']) ->select(); dump($result); } }

• 查询结果：

array(4) { [0] => array(3) { ["id"] => int(1006) ["name"] => string(9) "西门庆" ["hiredate"] => string(10) "2015-12-25" } [1] => array(3) { ["id"] => int(1008) ["name"] => string(6) "宋江" ["hiredate"] => string(10) "2015-12-31" } [2] => array(3) { ["id"] => int(1023) ["name"] => string(9) "段王爷" ["hiredate"] => string(10) "2015-12-31" } [3] => array(3) { ["id"] => int(1028) ["name"] => string(6) "方方" ["hiredate"] => string(10) "2015-12-31" } }

• 对应的SQL语句：

SELECT `id`,`name`,`hiredate` FROM `tp5_staff` WHERE `hiredate` BETWEEN '2015-01-01' AND '2016-01-01'

• SQLPRO for MySQL 中查询结果：

5、总结：

whereTime 与 where 无本质区别，可视为where针对日期字段的快捷方式，实际开发，具体用哪个随个人喜好，既然用了TP5，就尽可能选择使用TP5的新特性。