文档目录

日期和时间函数

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()返回年数和星期数