• 日期和时间函数
    • 日期时间函数表

    日期和时间函数

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