内置函数

 

时间函数

下载 编辑
更新时间 2023-09-06
函数 功能描述
DATE string 将 “yyyy-MM-dd” 形式表示的字符串 string 解析为 SQL 日期。
示例语句：insert into test SELECT Date ‘2022-05-25’ FROM TableTest;
TIME string 将 “HH:mm:ss” 形式表示的字符串 string 解析为 SQL 时间。
示例语句：insert into test SELECT Time ‘12:30:00’ FROM TableTest;
TIMESTAMP string 将 “yyyy-MM-dd HH:mm:ss[.SSS]” 形式表示的字符串 string 解析为 SQL 时间戳。
示例语句：insert into test SELECT Timestamp ‘2022-05-25 12:30:00’ FROM TableTest;
INTERVAL string range 返回时间间隔。string 有两种类型：
  • “dd hh:mm:ss.fff” 形式的字符串（毫秒），range 可以为 DAY、MINUTE、DAY TO HOUR、DAY TO SECOND。
  • “yyyy-MM” 形式的字符串（月），range 可以为 YEAR 或 YEAR TO MONTH。
    例如：
  • INTERVAL ‘10 00:00:00.004’ DAY TO SECOND 表示间隔 10 天 4 毫秒。
  • INTERVAL ‘10’ DAY 表示间隔 10 天。
  • INTERVAL ‘2-10’ YEAR TO MONTH 表示间隔 2 年 10 个月。
    		•
    CURRENT_DATE 返回 UTC 时区当前的 SQL 日期。
    CURRENT_TIME 返回 UTC 时区当前的 SQL 时间。
    CURRENT_TIMESTAMP 返回 UTC 时区当前的 SQL 时间戳。
    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) 返回指定日期的季度（取值范围：1~4 之间的整数）。相当于 EXTRACT(QUARTER FROM date)。
    例如：QUARTER(DATE ‘2012-09-10’) 返回 3。
    MONTH(date) 返回指定日期的月份（取值范围：1~12 之间的整数）。相当于 EXTRACT(MONTH FROM date)。
    例如：MONTH(DATE ‘2012-09-10’) 返回 9。
    WEEK(date) 返回指定日期的周数，即当年的第几周（取值范围：1~53 之间的整数）。相当于 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) 将一个时间点按 timeintervalunit 单位向下取整。
    例如：FLOOR(TIME ‘12:44:31’ TO MINUTE) 返回 12:44:00。
    CEIL(timepoint TO timeintervalunit) 将一个时间点按 timeintervalunit 单位向上取整。
    例如：CEIL(TIME ‘12:44:31’ TO MINUTE) 返回 12:45:00。
    (Timepoint1, temporal1) OVERLAPS (timepoint2, temporal2) 判断两个时间段是否重叠。时间值可以是时间点或时间间隔。
    例如：
  • (TIME ‘2:55:00’, INTERVAL ‘1’ HOUR) OVERLAPS (TIME ‘3:30:00’, INTERVAL ‘2’ HOUR) 返回 TRUE。
    (TIME ‘2:55:00’, INTERVAL ‘1’ HOUR) 表示的时间段是 2:55:00 到 3:55:00 （2:55:00+1:00:00）， (TIME ‘3:30:00’, INTERVAL ‘2’ HOUR) 表示的时间段是 3:30:00 到 5:30:00（3:30:00+2:00:00），重叠的时间段为 3:30:00 到 3:55:00，所以返回值为 TRUE。
  • (TIME ‘9:00:00’, TIME ‘10:00:00’) OVERLAPS (TIME ‘10:15:00’, INTERVAL ‘3’ HOUR) 返回 FALSE。
    (TIME ‘9:00:00’, TIME ‘10:00:00’) 表示的时间段是 9:00:00 到 10:00:00，(TIME ‘10:15:00’, INTERVAL ‘3’ HOUR) 表示的时间段是 10:15:00 到 13:15:00（10:15:00+3:00:00），两个时间段无重叠，所以返回值为 FALSE。
    		•
    TIMESTAMPADD(timeintervalunit, interval, timepoint) 对指定时间点 timestamp 增加一个时间段 interval（interval 可以为负数）。时间段单位 timeintervalunit 可以为 SECOND、MINUTE、HOUR、DAY、WEEK、MONTH、QUARTER、YEAR。
    例如：
  • TIMESTAMPADD(WEEK, 1, ‘2013-01-09’) 返回 2013-01-16。
  • TIMESTAMPADD(WEEK, -1, ‘2013-01-09’) 返回 2013-01-02。
    		•
    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’ ）从时区 string2 转换到时区 string3。时区支持缩写（例如 “PST”）、全称（例如 “Asia/Shanghai”）或者任意时区（例如 “GMT-8:00”）。
    例如：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’）转为 DATE 格式的日期。
    TO_TIMESTAMP(string1[, string2]) 将时间字符串 string1 以 string2 的格式（可选，默认是 ‘yyyy-MM-dd HH:mm:ss’）转为 TIMESTAMP 格式的时间。默认使用 UTC+8 时区，即北京时间（Asia/Shanghai）。
    NOW() 返回 UTC 时区当前的 SQL TIMESTAMP 时间戳。
    这篇文档解决了您的问题吗？
    0
    0