时间相关函数

最近更新时间:2020-09-17 16:27:21

时间相关函数的函数名和功能描述如下:

函数名 功能描述
DATE string 将 "yyyy-MM-dd" 形式表示的字符串转为 SQL 日期(DATE)类型。
TIME string 将 "HH:mm:ss" 形式表示的字符串转为 SQL 时间(TIME)类型。
TIMESTAMP string 将 "yyyy-MM-dd HH:mm:ss[.SSS]" 形式的字符串转为 SQL 时间戳(TIMESTAMP)类型。
INTERVAL string range 接受 "dd hh:mm:ss.fff" 形式的字符串(毫秒),或者 "yyyy-MM" 形式的字符串(月)。
  • 对于毫秒,可以接受 DAY、MINUTE、DAY TO HOUR、DAY TO SECOND 作为 range。
  • 对于月,接受 YEAR 或 YEAR TO MONTH 作为 range。例如 INTERVAL '10 00:00:00.004' DAY TO SECONDINTERVAL '10' DAYINTERVAL '2-10' YEAR TO MONTH
  • CURRENT_DATE 返回当前的 SQL DATE 格式表示的日期(UTC)。
    CURRENT_TIME 返回当前的 SQL TIME 格式表示的时间(UTC)。
    CURRENT_TIMESTAMP 返回当前 SQL TIMESTAMP 格式表示的时间戳(UTC)。
    LOCALTIME 返回本地时区表示的 SQL 时间。
    LOCALTIMESTAMP 返回本地时区表示的 SQL 时间戳。
    EXTRACT(timeintervalunit FROM temporal) 获取时间点或时间段字符串中的某项。例如 EXTRACT(DAY FROM DATE '2006-06-05') 返回5,而 EXTRACT(YEAR FROM DATE '2018-06-12') 则返回2018。
    YEAR(date) 返回指定日期中的年份,等价于 EXTRACT(YEAR FROM date)。例如 YEAR(DATE '2020-08-12') 返回2020。
    QUARTER(date) 返回指定日期的季度,等价于 EXTRACT(QUARTER FROM date)。例如 QUARTER(DATE '2012-09-10')返回3。
    MONTH(date) 返回指定日期的月份,等价于 EXTRACT(MONTH FROM date)。例如 MONTH(DATE '2012-09-10') 返回9。
    WEEK(date) 返回指定日期的周数,即当年的第几周,等价于 EXTRACT(WEEK FROM date)。例如 WEEK(DATE '1994-09-27') 返回39。
    DAYOFYEAR(date) 返回指定日期在当年的天数,即当年的第几天(范围是[1,366]),等价于 EXTRACT(DOY FROM date)。例如 DAYOFYEAR(DATE '1994-09-27') 返回270。
    DAYOFMONTH(date) 返回指定日期在当月的天数,即当月的第几天(范围是[1,31]),等价于 EXTRACT(DAY FROM date)。例如 DAYOFMONTH(DATE '1994-09-27') 返回27。
    DAYOFWEEK(date) 返回指定日期在本周的天数,即本周的第几天(范围是[1,7]),等价于 EXTRACT(DOW FROM date)。例如 DAYOFWEEK(DATE '1994-09-27') 返回3。
    HOUR(timestamp) 返回指定时间戳的小时部分(范围是[0,23])。等价于 EXTRACT(HOUR FROM timestamp)。例如 HOUR('2017-10-02 12:25:44') 返回12。
    MINUTE(timestamp) 返回指定时间戳的分钟部分(范围是[0,59])。等价于 EXTRACT(MINUTE FROM timestamp)。例如 MINUTE('2017-10-02 12:25:44') 返回25。
    SECOND(timestamp) 返回指定时间戳的秒部分(范围是[0,59])。等价于 EXTRACT(SECOND FROM timestamp)。例如 SECOND('2017-10-02 12:25:44') 返回44。
    FLOOR(timepoint TO timeintervalunit) 将一个时间点向下取整,例如 FLOOR(TIME '12:44:31' TO MINUTE) 返回12:44:00。
    CEIL(timepoint TO timeintervalunit) 将一个时间点向上取整,例如 CEIL(TIME '12:44:31' TO MINUTE) 返回12:45:00。
    (timepoint, temporal) OVERLAPS (timepoint, temporal) 判断两个时间段是否重叠。例如 (TIME
    '2:55:00', INTERVAL '1' HOUR) OVERLAPS (TIME
    '3:30:00', INTERVAL '2' HOUR) 返回 TRUE;而 (TIME
    '9:00:00', TIME '10:00:00') OVERLAPS (TIME
    '10:15:00', INTERVAL '3' HOUR) 返回 FALSE。
    TO_TIMESTAMP(string, simple_format) 将字符串格式的时间戳转为 Timestamp 类型。详见 类型转换函数
    DATE_FORMAT_SIMPLE (timestamp, simple_format) 将 BIGINT 类型以毫秒为单位的 Unix 时间戳格式化为字符串。详见 类型转换函数
    DATE_FORMAT(timestamp, format) 将 Timestamp 类型的时间戳格式化为字符串。详见 类型转换函数
    TIMESTAMP_TO_LONG(timestamp) 将 Timestamp 类型的时间戳转为 BIGINT 类型以毫秒或秒(可选)为单位的 Unix 时间戳。详见 类型转换函数
    TIMESTAMPADD(unit, interval, timestamp) 对指定 timestamp 增加一个时间段(允许为负数),单位区间必须为 SECOND、MINUTE、HOUR、DAY、WEEK、MONTH、QUARTER、YEAR 中的一种。例如 TIMESTAMPADD(WEEK, 1, '2013-01-02')返回'2013-01-09'。
    TIMESTAMPDIFF(timepointunit, timepoint1, timepoint2) 计算指定单位区间下,timepoint1 和 timepoint2 之间的时间差(允许为负数)。timepointunit 区间必须为 SECOND、MINUTE、HOUR、DAY、WEEK、MONTH、QUARTER、YEAR 中的一种。例如 TIMESTAMPDIFF(DAY, TIMESTAMP '2003-01-02 10:00:00', TIMESTAMP '2003-01-03 10:00:00') 返回1,即相差正1天。
    CONVERT_TZ(string1, string2, string3) 将 string1 表示的时间戳(必须是 'yyyy-MM-dd HH:mm:ss' 格式)从时区(允许缩写例如 "PST",全称例如 "Asia/Shanghai",或者任意时区例如 "GMT-8:00")string2 转换到时区 string3。例如 CONVERT('1970-01-01 00:00:00', 'UTC', 'America/Los_Angeles') 返回 '1969-12-31 16:00:00'。
    FROM_UNIXTIME(numeric[, string]) 返回 numeric 代表的 Unix 时间戳(从 1970-01-01 00:00:00 UTC 到现今的秒数)转为 'YYYY-MM-DD hh:mm:ss' 格式的字符串。默认使用 UTC+8 时区,即北京时间(Asia/Shanghai)
    UNIX_TIMESTAMP() 返回以秒为单位的 Unix 时间戳(从 1970-01-01 00:00:00 UTC 到现今的秒数),类型为 BIGINT。默认使用 UTC+8 时区,即北京时间(Asia/Shanghai)
    UNIX_TIMESTAMP(string1[, string2]) 将 string1 字符串以 string2 的格式(可选,默认是 'yyyy-MM-dd HH:mm:ss')转为 Unix 时间戳,类型为 BIGINT。
    TO_DATE(string1[, string2]) 将 string1 字符串以 string2 的格式(可选,默认是 'yyyy-MM-dd HH:mm:ss')转为 DATE 格式。
    TO_TIMESTAMP(string1[, string2]) 将 string1 字符串以 string2 的格式(可选,默认是 'yyyy-MM-dd HH:mm:ss')转为 TIMESTAMP 格式。默认使用 UTC+8 时区,即北京时间(Asia/Shanghai)
    NOW() 返回当前的 SQL TIMESTAMP 时间戳,时区为 UTC。