本文介绍了PolarDB-X支持的日期时间函数。

支持函数

PolarDB-X支持如下日期时间函数：

函数名 描述 示例
ADDDATE(d,n) 计算起始日期d加上n天的日期 SELECT ADDDATE("2017-06-15", INTERVAL 10 DAY);

返回：

->2017-06-25
ADDTIME(t,n) n是一个时间表达式，时间t加上时间表达式n
  • 加5秒：

    SELECT ADDTIME('2011-11-11 11:11:11', 5);

    返回：

    ->2011-11-11 11:11:16

  • 添加2小时10分钟5秒：

    SELECT ADDTIME("2020-06-15 09:34:21", "2:10:5");

    返回：

    -> 2020-06-15 11:44:26
CURDATE() 返回当前日期 SELECT CURDATE();

返回：

-> 2018-09-19
CURRENT_DATE() 返回当前日期

SELECT CURRENT_DATE();

返回：

-> 2018-09-19
CURRENT_TIME() 返回当前时间

SELECT CURRENT_TIME();

返回：

-> 19:59:02
CURRENT_TIMESTAMP() 返回当前日期和时间

SELECT CURRENT_TIMESTAMP();

返回：

-> 2018-09-19 20:57:43
CURTIME() 返回当前时间

SELECT CURTIME();

返回：

-> 19:59:02
DATE() 从日期或日期时间表达式中提取日期值

SELECT DATE("2017-06-15");

返回：

-> 2017-06-15
DATEDIFF(d1,d2) 计算日期d1和d2之间相隔的天数

SELECT DATEDIFF('2001-01-01','2001-02-02');

返回：

-> -32
DATE_ADD(d，INTERVAL expr type) 计算起始日期d加上一个时间段后的日期，type值可以是：
  • MICROSECOND
  • SECOND
  • MINUTE
  • HOUR
  • DAY
  • WEEK
  • MONTH
  • QUARTER
  • YEAR
  • SECOND_MICROSECOND
  • MINUTE_MICROSECOND
  • MINUTE_SECOND
  • HOUR_MICROSECOND
  • HOUR_SECOND
  • HOUR_MINUTE
  • DAY_MICROSECOND
  • DAY_SECOND
  • DAY_MINUTE
  • DAY_HOUR
  • YEAR_MONTH

  • SELECT DATE_ADD("2017-06-15", INTERVAL 10 DAY);

    返回：

    -> 2017-06-25

  • SELECT DATE_ADD("2017-06-15 09:34:21", INTERVAL 15 MINUTE);

    -> 2017-06-15 09:49:21

  • SELECT DATE_ADD("2017-06-15 09:34:21", INTERVAL -3 HOUR);

    返回：

    ->2017-06-15 06:34:21
DATE_FORMAT(d,f) 按表达式f的要求显示日期d

SELECT DATE_FORMAT('2011-11-11 11:11:11','%Y-%m-%d %r');

返回：

-> 2011-11-11 11:11:11 AM
DATE_SUB(date,INTERVAL expr type) 函数从日期减去指定的时间间隔 Orders表中OrderDate字段减去2天：

SELECT OrderId,DATE_SUB(OrderDate,INTERVAL 2 DAY) AS OrderPayDate FROM Orders
DAY(d) 返回日期值d的日期部分 SELECT DAY("2017-06-15");

返回：

-> 15
DAYNAME(d) 返回日期d是星期几，如Monday，Tuesday

SELECT DAYNAME('2011-11-11 11:11:11');

返回：

->Friday
DAYOFMONTH(d)) 计算日期d是本月的第几天

SELECT DAYOFMONTH('2011-11-11 11:11:11');

返回：

->11
DAYOFWEEK(d) 日期d今天是星期几，1星期日，2星期一，以此类推

SELECT DAYOFWEEK('2011-11-11 11:11:11');

返回：

->6
DAYOFYEAR(d) 计算日期d是本年的第几天

SELECT DAYOFYEAR('2011-11-11 11:11:11');

返回：

->315
EXTRACT(type FROM d) 从日期d中获取指定的值，type指定返回的值。

type可取值为：

  • MICROSECOND
  • SECOND
  • MINUTE
  • HOUR
  • DAY
  • WEEK
  • MONTH
  • QUARTER
  • YEAR
  • SECOND_MICROSECOND
  • MINUTE_MICROSECOND
  • MINUTE_SECOND
  • HOUR_MICROSECOND
  • HOUR_SECOND
  • HOUR_MINUTE
  • DAY_MICROSECOND
  • DAY_SECOND
  • DAY_MINUTE
  • DAY_HOUR
  • YEAR_MONTH

SELECT EXTRACT(MINUTE FROM '2011-11-11 11:11:11')

返回：

->11
FROM_DAYS(n) 计算从0000年1月1日开始n天后的日期

SELECT FROM_DAYS(1111)

返回：

-> 0003-01-16
HOUR(t) 返回t中的小时值

SELECT HOUR('1:2:3')

返回：

-> 1
LAST_DAY(d) 返回给定日期的那一月份的最后一天

SELECT LAST_DAY("2017-06-20");

返回：

-> 2017-06-30
LOCALTIME() 返回当前日期和时间

SELECT LOCALTIME()

返回：

-> 2018-09-19 20:57:43
LOCALTIMESTAMP() 返回当前日期和时间

SELECT LOCALTIMESTAMP()

返回：

-> 2018-09-19 20:57:43
MAKEDATE(year, day-of-year) 基于给定年份year和所在年中的天数序号day-of-year返回一个日期

SELECT MAKEDATE(2017, 3);

返回：

-> 2017-01-03
MAKETIME(hour, minute, second) 组合时间，参数分别为小时、分钟、秒

SELECT MAKETIME(11, 35, 4);

返回：

-> 11:35:04
MICROSECOND(date) 返回日期所对应的微秒数

SELECT MICROSECOND("2017-06-20 09:34:00.000023");

返回：

-> 23
MINUTE(t) 返回t中的分钟值

SELECT MINUTE('1:2:3');

返回：

-> 2
MONTHNAME(d) 返回日期当中的月份名称，如 November

SELECT MONTHNAME('2011-11-11 11:11:11');

返回：

-> November
MONTH(d) 返回日期d中的月份值，1到12

SELECT MONTH('2011-11-11 11:11:11');

返回：

->11
NOW() 返回当前日期和时间

SELECT NOW()

返回：

-> 2018-09-19 20:57:43
PERIOD_ADD(period, number) 为年-月组合日期添加一个时段

SELECT PERIOD_ADD(201703, 5);

返回：

-> 201708
PERIOD_DIFF(period1, period2) 返回两个时段之间的月份差值

SELECT PERIOD_DIFF(201710, 201703);

返回：

-> 7
QUARTER(d) 返回日期d是第几季度，返回1到4

SELECT QUARTER('2011-11-11 11:11:11');

返回：

-> 4
SECOND(t) 返回t中的秒钟值

SELECT SECOND('1:2:3')

返回：

-> 3
SEC_TO_TIME(s) 将以秒为单位的时间s转换为时分秒的格式

SELECT SEC_TO_TIME(4320);

返回：

-> 01:12:00
STR_TO_DATE(string, format_mask) 将字符串转变为日期

SELECT STR_TO_DATE("August 10 2017", "%M %d %Y");

返回：

-> 2017-08-10
SUBDATE(d,n) 日期d减去n天后的日期

SELECT SUBDATE('2011-11-11 11:11:11', 1);

返回：

->2011-11-10 11:11:11
SUBTIME(t,n) 时间t减去n秒的时间

SELECT SUBTIME('2011-11-11 11:11:11', 5);

返回：

->2011-11-11 11:11:06
SYSDATE() 返回当前日期和时间

SELECT SYSDATE();

返回：

-> 2018-09-19 20:57:43
TIME(expression) 提取传入表达式的时间部分

SELECT TIME("19:30:10");

返回：

-> 19:30:10
TIME_FORMAT(t,f) 按表达式f的要求显示时间t

SELECT TIME_FORMAT('11:11:11','%r');

返回：

-> 11:11:11 AM
TIME_TO_SEC(t) 将时间t转换为秒

SELECT TIME_TO_SEC('1:12:00');

返回：

-> 4320
TIMEDIFF(time1, time2) 计算时间差值

SELECT TIMEDIFF("13:10:11", "13:10:10");

返回：

-> 00:00:01
TIMESTAMP(expression, interval) 单个参数时，函数返回日期或日期时间表达式；有2个参数时，将参数加和

SELECT TIMESTAMP("2017-07-23", "13:10:11");

返回：

-> 2017-07-23 13:10:11
TO_DAYS(d) 计算日期d距离0000年1月1日的天数

SELECT TO_DAYS('0001-01-01 01:01:01');

返回：

-> 366
WEEK(d) 计算日期d是本年的第几个星期，范围是0到53

SELECT WEEK('2011-11-11 11:11:11');

返回：

-> 45
WEEKDAY(d) 日期d是星期几，0表示星期一，1表示星期二

SELECT WEEKDAY("2017-06-15");

返回：

-> 3
WEEKOFYEAR(d) 计算日期d是本年的第几个星期，范围是0到53

SELECT WEEKOFYEAR('2011-11-11 11:11:11');

返回：

-> 45
YEAR(d) 返回年份

SELECT YEAR("2017-06-15");

返回：

-> 2017
YEARWEEK(date, mode) 返回年份及第几周（0到53），mode中0表示周天，1表示周一，以此类推

SELECT YEARWEEK("2017-06-15");

返回：

-> 201724