mysql 时间函数

DAYOFWEEK(date)
返回日期date的星期索引(1=星期天,2=星期一, ……7=星期六)。这些索引值对应于ODBC标准。

1
2
3
4
5
6
mysql> select DAYOFWEEK('2017-01-06');
+-------------------------+
| DAYOFWEEK('2017-01-06') |
+-------------------------+
| 6 |
+-------------------------+

WEEKDAY(date)
返回date的星期索引(0=星期一,1=星期二, ……6= 星期天)。

1
2
3
4
5
6
mysql> select WEEKDAY('2017-01-06');
+-----------------------+
| WEEKDAY('2017-01-06') |
+-----------------------+
| 4 |
+-----------------------+

DAYOFMONTH(date)
返回date的月份中日期,在1到31范围内。

1
2
3
4
5
6
mysql> select DAYOFMONTH('2017-01-06');
+--------------------------+
| DAYOFMONTH('2017-01-06') |
+--------------------------+
| 6 |
+--------------------------+

DAYOFYEAR(date)
返回date在一年中的日数, 在1到366范围内。

1
2
3
4
5
6
mysql> select DAYOFYEAR('2016-12-31');
+-------------------------+
| DAYOFYEAR('2016-12-31') |
+-------------------------+
| 366 |
+-------------------------+

MONTH(date)
返回date的月份,范围1到12。

1
2
3
4
5
6
mysql> select MONTH('2017-01-06');
+---------------------+
| MONTH('2017-01-06') |
+---------------------+
| 1 |
+---------------------+

DAYNAME(date)
返回date的星期名字。

1
2
3
4
5
6
mysql> select DAYNAME("2017-01-06");
+-----------------------+
| DAYNAME("2017-01-06") |
+-----------------------+
| Friday |
+-----------------------+

MONTHNAME(date)
返回date的月份名字。

1
2
3
4
5
6
mysql> select MONTHNAME("2017-01-06");
+-------------------------+
| MONTHNAME("2017-01-06") |
+-------------------------+
| January |
+-------------------------+

QUARTER(date)
返回date一年中的季度,范围1到4。

1
2
3
4
5
6
mysql> select QUARTER('2016-12-31');
+-----------------------+
| QUARTER('2016-12-31') |
+-----------------------+
| 4 |
+-----------------------+

WEEK(date)、WEEK(date,first)
对于星期天是一周的第一天的地方,有一个单个参数,返回date的周数,范围在0到52。2个参数形式WEEK()允许你指定星期是否开始于星期天或星期一。如果第二个参数是0,星期从星期天开始,如果第二个参数是1,从星期一开始。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
mysql> select WEEK('2017-01-08');  
+--------------------+
| WEEK('2017-01-08') |
+--------------------+
| 2 |
+--------------------+
mysql> select WEEK('2017-01-08',0);
+----------------------+
| WEEK('2017-01-08',0) |
+----------------------+
| 2 |
+----------------------+
mysql> select WEEK('2017-01-08',1);
+----------------------+
| WEEK('2017-01-08',1) |
+----------------------+
| 1 |
+----------------------+

YEAR(date)
返回date的年份,范围在1000到9999。

1
2
3
4
5
6
mysql> select YEAR('2017-01-06');
+--------------------+
| YEAR('2017-01-06') |
+--------------------+
| 2017 |
+--------------------+

HOUR(time)
返回time的小时,范围是0到23。

1
2
3
4
5
6
mysql> select HOUR('12:05:03');
+------------------+
| HOUR('12:05:03') |
+------------------+
| 12 |
+------------------+

MINUTE(time)
返回time的分钟,范围是0到59。

1
2
3
4
5
6
mysql> select MINUTE('2017-01-06 12:05:03');
+-------------------------------+
| MINUTE('2017-01-06 12:05:03') |
+-------------------------------+
| 5 |
+-------------------------------+

SECOND(time)
回来time的秒数,范围是0到59。

1
2
3
4
5
6
mysql> select SECOND('12:05:03');
+--------------------+
| SECOND('12:05:03') |
+--------------------+
| 3 |
+--------------------+

PERIOD_ADD(P,N)
增加N个月到阶段P(以格式YYMM或YYYYMM)。以格式YYYYMM返回值。注意阶段参数P不是日期值。

1
2
3
4
5
6
mysql> select PERIOD_ADD(201701,2); 
+----------------------+
| PERIOD_ADD(201701,2) |
+----------------------+
| 201703 |
+----------------------+

PERIOD_DIFF(P1,P2)
返回在时期P1和P2之间月数,P1和P2应该以格式YYMM或YYYYMM。注意,时期参数P1和P2不是日期值。

1
2
3
4
5
6
mysql> select PERIOD_DIFF(1602,201701);
+--------------------------+
| PERIOD_DIFF(1602,201701) |
+--------------------------+
| -11 |
+--------------------------+

DATE_ADD(date,INTERVAL expr type)、DATE_SUB(date,INTERVAL expr type)、ADDDATE(date,INTERVAL expr type)、SUBDATE(date,INTERVAL expr type)
这些功能执行日期运算。对于MySQL 3.22,他们是新的。ADDDATE()和SUBDATE()是DATE_ADD()和DATE_SUB()的同义词。在MySQL 3.23中,你可以使用+和-而不是DATE_ADD()和DATE_SUB()。(见例子)date是一个指定开始日期的DATETIME或DATE值,expr是指定加到开始日期或从开始日期减去的间隔值一个表达式,expr是一个字符串;它可以以一个“-”开始表示负间隔。type是一个关键词,指明表达式应该如何被解释。EXTRACT(type FROM date)函数从日期中返回“type”间隔。下表显示了type和expr参数怎样被关联: type值 含义 期望的expr格式
SECOND 秒 SECONDS
MINUTE 分钟 MINUTES
HOUR 时间 HOURS
DAY 天 DAYS
MONTH 月 MONTHS
YEAR 年 YEARS
MINUTE_SECOND 分钟和秒 “MINUTES:SECONDS”
HOUR_MINUTE 小时和分钟 “HOURS:MINUTES”
DAY_HOUR 天和小时 “DAYS HOURS”
YEAR_MONTH 年和月 “YEARS-MONTHS”
HOUR_SECOND 小时, 分钟, “HOURS:MINUTES:SECONDS”
DAY_MINUTE 天, 小时, 分钟 “DAYS HOURS:MINUTES”
DAY_SECOND 天, 小时, 分钟, 秒 “DAYS HOURS:MINUTES:SECONDS”
MySQL在expr格式中允许任何标点分隔符。表示显示的是建议的分隔符。如果date参数是一个DATE值并且你的计算仅仅包含YEAR、MONTH和DAY部分(即,没有时间部分),结果是一个DATE值。否则结果是一个DATETIME值。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
mysql> SELECT "2017-01-06 12:05:03" + INTERVAL 1 SECOND;                 
+-------------------------------------------+
| "2017-01-06 12:05:03" + INTERVAL 1 SECOND |
+-------------------------------------------+
| 2017-01-06 12:05:04 |
+-------------------------------------------+
mysql> SELECT INTERVAL 1 DAY + "2017-01-06";
+-------------------------------+
| INTERVAL 1 DAY + "2017-01-06" |
+-------------------------------+
| 2017-01-07 |
+-------------------------------+
mysql> SELECT "2017-01-06" - INTERVAL 1 SECOND;
+----------------------------------+
| "2017-01-06" - INTERVAL 1 SECOND |
+----------------------------------+
| 2017-01-05 23:59:59 |
+----------------------------------+
mysql> SELECT DATE_ADD("2017-01-06 12:05:03", INTERVAL 1 SECOND);
+----------------------------------------------------+
| DATE_ADD("2017-01-06 12:05:03", INTERVAL 1 SECOND) |
+----------------------------------------------------+
| 2017-01-06 12:05:04 |
+----------------------------------------------------+
mysql> SELECT DATE_ADD("2017-01-06 12:05:03", INTERVAL 1 DAY);
+-------------------------------------------------+
| DATE_ADD("2017-01-06 12:05:03", INTERVAL 1 DAY) |
+-------------------------------------------------+
| 2017-01-07 12:05:03 |
+-------------------------------------------------+
mysql> SELECT DATE_ADD("2017-01-06 12:05:03", INTERVAL "1:1" MINUTE_SECOND);
+---------------------------------------------------------------+
| DATE_ADD("2017-01-06 12:05:03", INTERVAL "1:1" MINUTE_SECOND) |
+---------------------------------------------------------------+
| 2017-01-06 12:06:04 |
+---------------------------------------------------------------+
mysql> SELECT DATE_SUB("2017-01-06 12:05:03", INTERVAL "1 1:1:1" DAY_SECOND);
+----------------------------------------------------------------+
| DATE_SUB("2017-01-06 12:05:03", INTERVAL "1 1:1:1" DAY_SECOND) |
+----------------------------------------------------------------+
| 2017-01-05 11:04:02 |
+----------------------------------------------------------------+
mysql> SELECT DATE_ADD("2017-01-06 12:05:03", INTERVAL "-1 10" DAY_HOUR);
+------------------------------------------------------------+
| DATE_ADD("2017-01-06 12:05:03", INTERVAL "-1 10" DAY_HOUR) |
+------------------------------------------------------------+
| 2017-01-05 02:05:03 |
+------------------------------------------------------------+
mysql> SELECT DATE_SUB("2017-01-06", INTERVAL 31 DAY);
+-----------------------------------------+
| DATE_SUB("2017-01-06", INTERVAL 31 DAY) |
+-----------------------------------------+
| 2016-12-06 |
+-----------------------------------------+
mysql> SELECT EXTRACT(YEAR FROM "2017-01-06");
+---------------------------------+
| EXTRACT(YEAR FROM "2017-01-06") |
+---------------------------------+
| 2017 |
+---------------------------------+
mysql> SELECT EXTRACT(YEAR_MONTH FROM "2017-01-06 12:05:03");
+------------------------------------------------+
| EXTRACT(YEAR_MONTH FROM "2017-01-06 12:05:03") |
+------------------------------------------------+
| 201701 |
+------------------------------------------------+
mysql> SELECT EXTRACT(DAY_MINUTE FROM "2017-01-06 12:05:03");
+------------------------------------------------+
| EXTRACT(DAY_MINUTE FROM "2017-01-06 12:05:03") |
+------------------------------------------------+
| 61205 |
+------------------------------------------------+

如果你指定太短的间隔值(不包括type关键词期望的间隔部分),MySQL假设你省掉了间隔值的最左面部分。例如,如果你指定一个type是DAY_SECOND,值expr被希望有天、小时、分钟和秒部分。如果你象”1:10”这样指定值,MySQL假设日子和小时部分是丢失的并且值代表分钟和秒。换句话说,”1:10” DAY_SECOND以它等价于”1:10” MINUTE_SECOND的方式解释,这对那MySQL解释TIME值表示经过的时间而非作为一天的时间的方式有二义性。如果你使用确实不正确的日期,结果是NULL。如果你增加MONTH、YEAR_MONTH或YEAR并且结果日期大于新月份的最大值天数,日子在新月用最大的天调整。

1
2
3
4
5
6
mysql> select DATE_ADD('2017-01-06', Interval 1 month);          
+------------------------------------------+
| DATE_ADD('2017-01-06', Interval 1 month) |
+------------------------------------------+
| 2017-02-06 |
+------------------------------------------+

注意,从前面的例子中词INTERVAL和type关键词不是区分大小写的。

TO_DAYS(date)
给出一个日期date,返回一个天数(从0年的天数)。

1
2
3
4
5
6
7
8
9
10
11
12
mysql> select TO_DAYS(170106);
+-----------------+
| TO_DAYS(170106) |
+-----------------+
| 736700 |
+-----------------+
mysql> select TO_DAYS('2017-01-06');
+-----------------------+
| TO_DAYS('2017-01-06') |
+-----------------------+
| 736700 |
+-----------------------+

FROM_DAYS(N)
给出一个天数N,返回一个DATE值。

1
2
3
4
5
6
mysql> select FROM_DAYS(736700);
+-------------------+
| FROM_DAYS(736700) |
+-------------------+
| 2017-01-06 |
+-------------------+

DATE_FORMAT(date,format)
根据format字符串格式化date值。下列修饰符可以被用在format字符串中: %M 月名字(January……December)
%W 星期名字(Sunday……Saturday)
%D 有英语前缀的月份的日期(1st, 2nd, 3rd, 等等。)
%Y 年, 数字, 4 位
%y 年, 数字, 2 位
%a 缩写的星期名字(Sun……Sat)
%d 月份中的天数, 数字(00……31)
%e 月份中的天数, 数字(0……31)
%m 月, 数字(01……12)
%c 月, 数字(1……12)
%b 缩写的月份名字(Jan……Dec)
%j 一年中的天数(001……366)
%H 小时(00……23)
%k 小时(0……23)
%h 小时(01……12)
%I 小时(01……12)
%l 小时(1……12)
%i 分钟, 数字(00……59)
%r 时间,12 小时(hh:mm:ss [AP]M)
%T 时间,24 小时(hh:mm:ss)
%S 秒(00……59)
%s 秒(00……59)
%p AM或PM
%w 一个星期中的天数(0=Sunday ……6=Saturday )
%U 星期(0……52), 这里星期天是星期的第一天
%u 星期(0……52), 这里星期一是星期的第一天
%% 一个文字“%”。

所有的其他字符不做解释被复制到结果中。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
mysql> select DATE_FORMAT('2017-01-06 12:05:03', '%W %M %Y');                   
+------------------------------------------------+
| DATE_FORMAT('2017-01-06 12:05:03', '%W %M %Y') |
+------------------------------------------------+
| Friday January 2017 |
+------------------------------------------------+
mysql> select DATE_FORMAT('2017-01-06 12:05:03', '%H:%i:%s');
+------------------------------------------------+
| DATE_FORMAT('2017-01-06 12:05:03', '%H:%i:%s') |
+------------------------------------------------+
| 12:05:03 |
+------------------------------------------------+
mysql> select DATE_FORMAT('2017-01-06 12:05:03', '%D %y %a %d %m %b %j');
+------------------------------------------------------------+
| DATE_FORMAT('2017-01-06 12:05:03', '%D %y %a %d %m %b %j') |
+------------------------------------------------------------+
| 6th 17 Fri 06 01 Jan 006 |
+------------------------------------------------------------+
mysql> select DATE_FORMAT('2017-01-06 12:05:03', '%H %k %I %r %T %S %w');
+------------------------------------------------------------+
| DATE_FORMAT('2017-01-06 12:05:03', '%H %k %I %r %T %S %w') |
+------------------------------------------------------------+
| 12 12 12 12:05:03 PM 12:05:03 03 5 |
+------------------------------------------------------------+

TIME_FORMAT(time,format)
这象上面的DATE_FORMAT()函数一样使用,但是format字符串只能包含处理小时、分钟和秒的那些格式修饰符。其他修饰符产生一个NULL值或0。

CURDATE()、CURRENT_DATE
以’YYYY-MM-DD’或YYYYMMDD格式返回今天日期值,取决于函数是在一个字符串还是数字上下文被使用。

1
2
3
4
5
6
7
8
9
10
11
12
mysql> select CURDATE();
+------------+
| CURDATE() |
+------------+
| 2017-01-06 |
+------------+
mysql> select CURDATE()+2;
+-------------+
| CURDATE()+2 |
+-------------+
| 20170108 |
+-------------+

CURRENT_TIME
以’HH:MM:SS’或HHMMSS格式返回当前时间值,取决于函数是在一个字符串还是在数字的上下文被使用。

1
2
3
4
5
6
mysql> select CURTIME();
+-----------+
| CURTIME() |
+-----------+
| 13:55:04 |
+-----------+

NOW()、SYSDATE()、CURRENT_TIMESTAMP
以’YYYY-MM-DD HH:MM:SS’或YYYYMMDDHHMMSS格式返回当前的日期和时间,取决于函数是在一个字符串还是在数字的上下文被使用。

1
2
3
4
5
6
mysql> select NOW();
+---------------------+
| NOW() |
+---------------------+
| 2017-01-06 13:57:02 |
+---------------------+

UNIX_TIMESTAMP()、UNIX_TIMESTAMP(date)
如果没有参数调用,返回一个Unix时间戳记(从’1970-01-01 00:00:00’GMT开始的秒数)。如果UNIX_TIMESTAMP()用一个date参数被调用,它返回从’1970-01-01 00:00:00’ GMT开始的秒数值。date可以是一个DATE字符串、一个DATETIME字符串、一个TIMESTAMP或以YYMMDD或YYYYMMDD格式的本地时间的一个数字。

1
2
3
4
5
6
7
8
9
10
11
12
mysql> select UNIX_TIMESTAMP();
+------------------+
| UNIX_TIMESTAMP() |
+------------------+
| 1483682742 |
+------------------+
mysql> select UNIX_TIMESTAMP('2017-01-06 12:05:03');
+---------------------------------------+
| UNIX_TIMESTAMP('2017-01-06 12:05:03') |
+---------------------------------------+
| 1483675503 |
+---------------------------------------+

当UNIX_TIMESTAMP被用于一个TIMESTAMP列,函数将直接接受值,没有隐含的“string-to-unix-timestamp”变换。

FROM_UNIXTIME(unix_timestamp)
以’YYYY-MM-DD HH:MM:SS’或YYYYMMDDHHMMSS格式返回unix_timestamp参数所表示的值,取决于函数是在一个字符串还是或数字上下文中被使用。

1
2
3
4
5
6
mysql> select FROM_UNIXTIME(1483682742);
+---------------------------+
| FROM_UNIXTIME(1483682742) |
+---------------------------+
| 2017-01-06 14:05:42 |
+---------------------------+

FROM_UNIXTIME(unix_timestamp,format)
返回表示 Unix 时间标记的一个字符串,根据format字符串格式化。format可以包含与DATE_FORMAT()函数列出的条目同样的修饰符。

1
2
3
4
5
6
mysql> select FROM_UNIXTIME(UNIX_TIMESTAMP(), '%Y %D %M %h:%i:%s %x');
+---------------------------------------------------------+
| FROM_UNIXTIME(UNIX_TIMESTAMP(), '%Y %D %M %h:%i:%s %x') |
+---------------------------------------------------------+
| 2017 6th January 02:23:08 2017 |
+---------------------------------------------------------+

SEC_TO_TIME(seconds)
返回seconds参数,变换成小时、分钟和秒,值以’HH:MM:SS’或HHMMSS格式化,取决于函数是在一个字符串还是在数字上下文中被使用。

1
2
3
4
5
6
mysql> select SEC_TO_TIME(2378);
+-------------------+
| SEC_TO_TIME(2378) |
+-------------------+
| 00:39:38 |
+-------------------+

TIME_TO_SEC(time)
返回time参数,转换成秒。

1
2
3
4
5
6
mysql> select TIME_TO_SEC('14:05:42');         
+-------------------------+
| TIME_TO_SEC('14:05:42') |
+-------------------------+
| 50742 |
+-------------------------+