日期和时间函数

日期和时间函数

TiDB 中日期和时间函数的使用方法与 MySQL 基本一致，详情参见: Date and Time Functions.

日期时间函数表

函数名	功能描述
`ADDDATE()`	将时间间隔添加到日期上
`ADDTIME()`	时间数值相加
`CONVERT_TZ()`	转换时区
`CURDATE()`	返回当前日期
`CURRENT_DATE()`, `CURRENT_DATE`	与 CURDATE() 同义
`CURRENT_TIME()`, `CURRENT_TIME`	与 CURTIME() 同义
`CURRENT_TIMESTAMP()`, `CURRENT_TIMESTAMP`	与 NOW() 同义
`CURTIME()`	返回当前时间
`DATE()`	从日期或日期/时间表达式中提取日期部分
`DATE_ADD()`	将时间间隔添加到日期上
`DATE_FORMAT()`	返回满足指定格式的日期/时间
`DATE_SUB()`	从日期减去指定的时间间隔
`DATEDIFF()`	返回两个日期间隔的天数
`DAY()`	与 DAYOFMONTH() 同义
`DAYNAME()`	返回星期名称
`DAYOFMONTH()`	返回参数对应的天数部分(1-31)
`DAYOFWEEK()`	返回参数对应的星期下标
`DAYOFYEAR()`	返回参数代表一年的哪一天 (1-366)
`EXTRACT()`	提取日期/时间中的单独部分
`FROM_DAYS()`	将天数转化为日期
`FROM_UNIXTIME()`	将 Unix 时间戳格式化为日期
`GET_FORMAT()`	返回满足日期格式的字符串
`HOUR()`	提取日期/时间表达式中的小时部分
`LAST_DAY`	返回参数中月份的最后一天
`LOCALTIME()`, `LOCALTIME`	与 NOW() 同义
`LOCALTIMESTAMP`, `LOCALTIMESTAMP()`	与 NOW() 同义
`MAKEDATE()`	根据给定的年份和一年中的天数生成一个日期
`MAKETIME()`	根据给定的时、分、秒生成一个时间
`MICROSECOND()`	返回参数的微秒部分
`MINUTE()`	返回参数的分钟部分
`MONTH()`	返回参数的月份部分
`MONTHNAME()`	返回参数的月份名称
`NOW()`	返回当前日期和时间
`PERIOD_ADD()`	在年-月表达式上添加一段时间(数个月)
`PERIOD_DIFF()`	返回间隔的月数
`QUARTER()`	返回参数对应的季度(1-4)
`SEC_TO_TIME()`	将秒数转化为 ‘HH:MM:SS’ 的格式
`SECOND()`	返回秒数(0-59)
`STR_TO_DATE()`	将字符串转化为日期
`SUBDATE()`	当传入三个参数时作为 DATE_SUB() 的同义
`SUBTIME()`	从一个时间中减去一段时间
`SYSDATE()`	返回该方法执行时的时间
`TIME()`	返回参数的时间表达式部分
`TIME_FORMAT()`	格式化时间
`TIME_TO_SEC()`	返回参数对应的秒数
`TIMEDIFF()`	返回时间间隔
`TIMESTAMP()`	传入一个参数时候,该方法返回日期或日期/时间表达式, 传入两个参数时候, 返回参数的和
`TIMESTAMPADD()`	在日期/时间表达式上增加一段时间间隔
`TIMESTAMPDIFF()`	从日期/时间表达式中减去一段时间间隔
`TO_DAYS()`	将参数转化对应的天数(从第 0 年开始)
`TO_SECONDS()`	将日期或日期/时间参数转化为秒数(从第 0 年开始)
`UNIX_TIMESTAMP()`	返回一个 Unix 时间戳
`UTC_DATE()`	返回当前的 UTC 日期
`UTC_TIME()`	返回当前的 UTC 时间
`UTC_TIMESTAMP()`	返回当前的 UTC 日期和时间
`WEEK()`	返回参数所在的一年中的星期数
`WEEKDAY()`	返回星期下标
`WEEKOFYEAR()`	返回参数在日历中对应的一年中的星期数
`YEAR()`	返回参数对应的年数
`YEARWEEK()`	返回年数和星期数