时间函数_内置函数_函数_Flink Opensource SQL1.15语法参考_Flink SQL语法参考

函数说明

表1 时间函数
函数	返回值	描述
DATE string	DATE	以“yyyy-MM-dd”的形式返回从字符串解析的 SQL 日期。
DATE_ADD	STRING	指定日期增加目标天数后的日期，数据类型为STRING。
DATE_SUB	STRING	指定日期减去目标天数后的日期，数据类型为STRING。
TIME string	TIME	以“HH:mm:ss”的形式返回从字符串解析的 SQL 时间。
TIMESTAMP string	TIMESTAMP	以“yyyy-MM-dd HH:mm:ss[.SSS]”的形式返回从字符串解析的 SQL 时间戳。
INTERVAL string range	INTERVAL	从“dd hh:mm:ss.fff”形式的字符串解析 SQL 毫秒间隔或者从“yyyy-mm”形式的字符串解析 SQL 月数间隔。间隔范围可以是 DAY，MINUTE，DAY TO HOUR 或 DAY TO SECOND，以毫秒为间隔；YEAR 或 YEAR TO MONTH 表示几个月的间隔。例如 INTERVAL '10 00:00:00.004' DAY TO SECOND，INTERVAL '10' DAY 或 INTERVAL '2-10' YEAR TO MONTH 返回间隔。
CURRENT_DATE	DATE	返回本地时区中的当前 SQL 日期。在流模式下为每条记录进行取值。但在批处理模式下，它在查询开始时计算一次，并对每一行使用相同的结果。
CURRENT_TIME	TIME	返回本地时区的当前 SQL 时间，这是 LOCAL_TIME 的同义词。
CURRENT_TIMESTAMP	TIMESTAMP	返回本地时区的当前 SQL 时间戳，返回类型为 TIMESTAMP_LTZ(3)。在流模式下为每条记录进行取值。但在批处理模式下，它在查询开始时计算一次，并对每一行使用相同的结果。
LOCALTIME	TIME	返回本地时区的当前 SQL 时间，返回类型为 TIME(0)。在流模式下为每条记录进行取值。但在批处理模式下，它在查询开始时计算一次，并对每一行使用相同的结果。
LOCALTIMESTAMP	TIMESTAMP	返回本地时区的当前 SQL 时间，返回类型为 TIMESTAMP(3)。在流模式下为每条记录进行取值。但在批处理模式下，它在查询开始时计算一次，并对每一行使用相同的结果。
NOW()	TIMESTAMP	返回本地时区的当前 SQL 时间戳，这是 CURRENT_TIMESTAMP 的同义词。
CURRENT_ROW_TIMESTAMP()	TIMESTAMP_LTZ(3)	返回本地时区的当前 SQL 时间戳，返回类型为 TIMESTAMP_LTZ(3)。无论是在批处理模式还是流模式下，都会为每条记录进行取值。
EXTRACT(timeintervalunit FROM temporal)	BIGINT	返回从时间的时间间隔单位部分提取的 long 值。例如 EXTRACT(DAY FROM DATE '2006-06-05') 返回 5。
YEAR(date)	BIGINT	从 SQL 日期 date 返回年份。相当于 EXTRACT(YEAR FROM date)。例如 YEAR(DATE '1994-09-27') 返回 1994。
QUARTER(date)	BIGINT	从 SQL 日期 date 返回一年中的季度（1 到 4 之间的整数）。相当于 EXTRACT(QUARTER FROM date)。例如 QUARTER(DATE '1994-09-27') 返回 3。
MONTH(date)	BIGINT	从 SQL 日期 date 返回一年中的月份（1 到 12 之间的整数）。相当于 EXTRACT(MONTH FROM date)。例如 MONTH(DATE '1994-09-27') 返回 9。
WEEK(date)	BIGINT	从 SQL 日期 date 返回一年中的第几周（1 到 53 之间的整数）。相当于 EXTRACT(WEEK FROM date)。例如 WEEK(DATE '1994-09-27') 返回 39。
DAYOFYEAR(date)	BIGINT	从 SQL 日期 date 返回一年中的第几天（1 到 366 之间的整数）。相当于 EXTRACT(DOY FROM date)。例如 DAYOFYEAR(DATE '1994-09-27') 返回 270。
DAYOFMONTH(date)	BIGINT	从 SQL 日期 date 返回一个月中的第几天（1 到 31 之间的整数）。相当于 EXTRACT(DAY FROM date)。例如 DAYOFWEEK(DATE '1994-09-27') 返回 3。
DAYOFWEEK(date)	BIGINT	计算当前日期是当前周的第几天其中周日设为1 例如：DAYOFWEEK(DATE '1994-09-27') 返回3
HOUR(timestamp)	BIGINT	从 SQL 时间戳 timestamp 返回小时单位部分的小时（0 到 23 之间的整数）数。相当于 EXTRACT(HOUR FROM timestamp)。例如 MINUTE(TIMESTAMP '1994-09-27 13:14:15') 返回 14。
MINUTE(timestamp)	BIGINT	从 SQL 时间戳 timestamp 返回分钟单位的分钟数（0 到 59 之间的整数）。相当于 EXTRACT(MINUTE FROM timestamp)。例如 MINUTE(TIMESTAMP '1994-09-27 13:14:15') 返回 14。
SECOND(timestamp)	BIGINT	从 SQL 时间戳 timestamp 返回秒单位部分的秒数（0 到 59 之间的整数）。相当于 EXTRACT(SECOND FROM timestamp)。例如 SECOND(TIMESTAMP '1994-09-27 13:14:15') 返回 15。
FLOOR(timepoint TO timeintervalunit)	TIME	返回将时间点 timepoint 向下取值到时间单位 timeintervalunit 的值。例如 FLOOR(TIME '12:44:31' TO MINUTE) 返回 12:44:00。
CEIL(timepoint TO timeintervalunit)	TIME	返回将时间点 timepoint 向上取值到时间单位 TIMEINTERVALUNIT 的值。例如 CEIL(TIME '12:44:31' TO MINUTE) 返回 12:45:00。
(timepoint1, temporal1) OVERLAPS (timepoint2, temporal2)	BOOLEAN	如果由 (timepoint1, temporal1) 和 (timepoint2, temporal2) 定义的两个时间间隔重叠，则返回 TRUE。时间值可以是时间点或时间间隔。例如 (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。
DATE_FORMAT(timestamp, string)	STRING	将时间戳 timestamp 转换为日期格式字符串 string 指定格式的字符串值。格式字符串与 Java 的 SimpleDateFormat 兼容。
TIMESTAMPADD(timeintervalunit, interval, timepoint)	TIMESTAMP/DATE/TIME	将整型interval与timeintervalunit组成的结果添加日期或日期时间到timepoint中，并返回添加后的日期时间例如：TIMESTAMPADD(WEEK, 1, DATE '2003-01-02') 返回2003-01-09
TIMESTAMPDIFF(timepointunit, timepoint1, timepoint2)	INT	返回 timepoint1 和 timepoint2 之间时间间隔。间隔的单位由第一个参数给出，它应该是以下值之一： SECOND，MINUTE，HOUR，DAY，MONTH 或 YEAR。
CONVERT_TZ(string1, string2, string3)	TIMESTAMP	日期时间 string1（具有默认 ISO 时间戳格式 ‘yyyy-MM-dd HH:mm:ss’）从时区 string2 转换为时区 string3 的值。时区的格式应该是缩写如“PST”，全名如“Country A/City A”，或自定义 ID 如“GMT-08:00”。例如 CONVERT_TZ('1970-01-01 00:00:00', 'UTC', 'Country A/City A') 返回 '1969-12-31 16:00:00’。
FROM_UNIXTIME(numeric[, string])	STRING	以字符串格式 string 返回数字参数 numberic 的表示形式（默认为 ‘yyyy-MM-dd HH:mm:ss’）。numeric 是一个内部时间戳值，表示自'1970-01-01 00:00:00’ UTC 以来的秒数，由 UNIX_TIMESTAMP() 函数生成。返回值以会话时区表示（在 TableConfig 中指定）。例如，如果在 UTC 时区，FROM_UNIXTIME(44) 返回 ‘1970-01-01 00:00:44’，如果在 ‘Asia/Tokyo’ 时区，则返回 ‘1970-01-01 09:00:44’。
UNIX_TIMESTAMP()	BIGINT	以秒为单位获取当前的 Unix 时间戳。此函数不是确定性的，这意味着将为每个记录重新计算该值。
UNIX_TIMESTAMP(string1[, string2])	BIGINT	使用表配置中指定的时区将格式为 string2 的日期时间字符串 string1（如果未指定默认情况下：yyyy-MM-dd HH:mm:ss）转换为 Unix 时间戳（以秒为单位）。
TO_DATE(string1[, string2])	DATE	将格式为 string2（默认为 ‘yyyy-MM-dd’）的字符串 string1 转换为日期。
TO_TIMESTAMP_LTZ(numeric, precision)	TIMESTAMP_LTZ	将纪元秒或纪元毫秒转换为 TIMESTAMP_LTZ，有效精度为 0 或 3，0 代表 TO_TIMESTAMP_LTZ(epochSeconds, 0)， 3 代表 TO_TIMESTAMP_LTZ(epochMilliseconds, 3)。
TO_TIMESTAMP(string1[, string2])	TIMESTAMP	将 ‘UTC+0’ 时区下格式为 string2（默认为：‘yyyy-MM-dd HH:mm:ss’）的字符串 string1 转换为时间戳。
CURRENT_WATERMARK(rowtime)	-	返回给定时间列属性rowtime 的当前水印，如果管道中的当前操作没有可用的上游操作的公共水印时则为 NULL。函数的返回类型被推断为与提供的时间列属性匹配，但调整后的精度为 3。例如时间列属性为 TIMESTAMP_LTZ(9)，则函数将返回 TIMESTAMP_LTZ(3)。请注意，此函数可以返回 NULL，您可能必须考虑这种情况。例如，如果您想过滤掉后期数据，您可以使用： WHERE CURRENT_WATERMARK(ts) IS NULL OR ts > CURRENT_WATERMARK(ts)

DATE

功能描述
DATE函数将"yyyy-MM-dd"日期格式的字符串解析为DATE类型的日期。
语法说明
```
DATE DATE string
```

入参说明

参数名	数据类型	参数说明
string	STRING	SQL日期格式的字符串。注意该字符串的格式必须为"yyyy-MM-dd"格式，否则语义校验会报错。

参数名

数据类型

参数说明

string

STRING

SQL日期格式的字符串。

注意该字符串的格式必须为"yyyy-MM-dd"格式，否则语义校验会报错。

示例

测试语句

SELECT 
	DATE "2021-08-19" AS `result`
FROM
	testtable;

测试结果

result

2021-08-19

result
2021-08-19

DATE_ADD

功能描述
DATE_ADD函数返回指定日期增加目标天数后的日期。
语法说明
```
DATE_ADD(string startdate, int days)
```
入参说明
- startdate 指定时间，数据类型为TIMESTAMP或者STRING。
  
  STRING类型日期格式为yyyy-MM-dd HH:mm:ss。
  
  支持参数为NULL的特殊情况处理
- days 目标天数，数据类型为INT。
返回值
指定日期增加目标天数后的日期，数据类型为STRING。

示例

提交FlinkSQL语句

CREATE TABLE source (
  time1 TIMESTAMP
) WITH (
  'connector' = 'datagen',
  'rows-per-second' = '1'
);
create table Sink (
  date1 string,
  date2 string,
  date3 string
) with ('connector' = 'print');
INSERT into
  Sink
select
  DATE_ADD(time1, 30) as date1,
  DATE_ADD('2017-09-15 00:00:00', 30) as date2,
  DATE_ADD(cast(null as timestamp),30) as date3
FROM source

测试结果

date1 (string)	date2 (string)	date3 (string)
2024-06-28	2017-10-15	null

DATE_SUB

功能描述
DATE_SUB函数返回指定日期减去目标天数后的日期。
语法说明
```
DATE_SUB(string startdate, int days)
```
入参说明
- startdate 指定时间，数据类型为TIMESTAMP或者STRING。
  
  STRING类型日期格式为yyyy-MM-dd HH:mm:ss。
  
  支持参数为NULL的特殊情况处理
- days 目标天数，数据类型为INT。
返回值
指定日期减去目标天数后的日期，数据类型为STRING。

示例

提交FlinkSQL语句

CREATE TABLE source (
  time1 TIMESTAMP
) WITH (
  'connector' = 'datagen',
  'rows-per-second' = '1'
);
create table Sink (
  date1 string,
  date2 string,
  date3 string
) with ('connector' = 'print');
INSERT into
  Sink
select
  DATE_SUB(time1,30) as date1,
  DATE_SUB('2017-09-15 00:00:00', 30) as date2,
  DATE_SUB(cast(null as timestamp),30) as date3
FROM source

测试结果

date1 (string)	date2 (string)	date3 (string)
2024-04-29	2017-08-16	null

TIME

功能描述
将时间字符串以"HH:mm:ss[.fff]"形式解析为SQL时间，结果以TIME类型返回。
语法说明
```
TIME TIME string
```

入参说明

参数名	数据类型	参数说明
string	STRING	时间字符串。注意该字符串格式必须"HH:mm:ss[.fff]"，否则语义校验会报错。

参数名

数据类型

参数说明

string

STRING

时间字符串。

注意该字符串格式必须"HH:mm:ss[.fff]"，否则语义校验会报错。

示例

测试语句

SELECT 
	TIME "10:11:12" AS `result`,
        TIME "10:11:12.032" AS `result2`
FROM
	testtable;

测试结果

result	result2
10:11:12	10:11:12.032

TIMESTAMP

功能描述
将时间字符串转换为时间戳，时间字符串格式为："yyyy-MM-dd HH:mm:ss[.fff]"，以TIMESTAMP(3)类型返回。
语法说明
```
TIMESTAMP(3) TIMESTAMP string
```

入参说明

参数名	数据类型	参数说明
string	STRING	时间戳字符串。注意该字符串格式必须为"yyyy-MM-dd HH:mm:ss[.fff]"，否则语义校验会报错。

参数名

数据类型

参数说明

string

STRING

时间戳字符串。

注意该字符串格式必须为"yyyy-MM-dd HH:mm:ss[.fff]"，否则语义校验会报错。

示例

测试语句

SELECT 
	TIMESTAMP "1997-04-25 13:14:15" AS `result`,
        TIMESTAMP "1997-04-25 13:14:15.032" AS `result2`
FROM
	testtable;

测试结果

result	result2
1997-04-25 13:14:15	1997-04-25 13:14:15.032

INTERVAL

功能描述
INTERVAL函数用于表示时间间隔。
语法说明
```
INTERVAL INTERVAL string range
```

入参说明

参数名	数据类型	参数说明
string	STRING	时间戳字符串，搭配参数range使用。两种格式类型，分别为：一种为"yyyy-MM"即保存年份和月份，精度到月份，它的range参数可以为YEAR或者YEAR To Month。一种为天时间"dd HH:mm:sss.fff"，用来保存天数、小时、分钟、秒和毫秒，精度最低到毫秒。它的range参数可以为DAY、MINUTE、DAY TO HOUR、DAY TO SECOND。
range	INTERVAL	时间间隔说明，搭配string参数使用，详细请参考string参数说明。取值范围为：YEAR、YEAR To Month、DAY、MINUTE、DAY TO HOUR、DAY TO SECOND。

参数名

数据类型

参数说明

string

STRING

时间戳字符串，搭配参数range使用。两种格式类型，分别为：

一种为"yyyy-MM"即保存年份和月份，精度到月份，它的range参数可以为YEAR或者YEAR To Month。
一种为天时间"dd HH:mm:sss.fff"，用来保存天数、小时、分钟、秒和毫秒，精度最低到毫秒。它的range参数可以为DAY、MINUTE、DAY TO HOUR、DAY TO SECOND。

range

INTERVAL

时间间隔说明，搭配string参数使用，详细请参考string参数说明。

取值范围为：YEAR、YEAR To Month、DAY、MINUTE、DAY TO HOUR、DAY TO SECOND。

示例

测试语句

--表示间隔10天4毫秒。
INTERVAL '10 00:00:00.004' DAY TO second
--DAY表示间隔10天
INTERVAL '10' 
--表示间隔2年10个月
INTERVAL '2-10' YEAR TO MONTH

CURRENT_DATE

功能描述
以UTC时区"yyyy-MM-dd"格式返回当前SQL日期，返回类型为DATE。
语法说明
```
DATE CURRENT_DATE
```
入参说明
无。

示例

测试语句

SELECT 
	CURRENT_DATE AS `result`
FROM
	testtable;

测试结果

result

2021-10-28

result
2021-10-28

CURRENT_TIME

功能描述
以UTC（UTC+0）时区“HH:mm:sss.fff”格式返回当前SQL时间，返回类型为TIME。
语法说明
```
TIME CURRENT_TIME
```
入参说明
无。

示例

测试语句

SELECT 
	CURRENT_TIME AS `result`
FROM
	testtable;

测试结果

result

08:29:19.289

result
08:29:19.289

CURRENT_TIMESTAMP

功能描述
以UTC（UTC+0）时区返回当前SQL时间戳，返回类型为TIMESTAMP(3)。
语法说明
```
TIMESTAMP(3) CURRENT_TIMESTAMP
```
入参说明
无。
示例
- 测试语句
```
SELECT 
	CURRENT_TIMESTAMP AS `result`
FROM
	testtable;
```
- 测试结果
  
  result
  
  2021-10-28 08:33:51.606

result
2021-10-28 08:33:51.606

LOCALTIME

功能描述
返回当前时区的当前SQL时间，返回类型为TIME。
语法说明
```
TIME LOCALTIME
```
入参说明
无。
示例
- 测试语句
```
SELECT 
	LOCALTIME AS `result`
FROM
	testtable;
```
- 测试结果
  
  result
  
  16:39:37.706

result
16:39:37.706

LOCALTIMESTAMP

功能描述
返回当前时区的当前SQL时间戳，返回类型为TIMESTAMP(3)。
语法说明
```
TIMESTAMP(3) LOCALTIMESTAMP
```
入参说明
无。
示例
- 测试语句
```
SELECT 
	LOCALTIMESTAMP AS `result`
FROM
	testtable;
```
- 测试结果
  
  result
  
  2021-10-28 16:43:17.625

result
2021-10-28 16:43:17.625

EXTRACT

功能描述
提取时间点或时间间隔中指定某一时间单位的部分，以BIGINT类型返回。

语法说明

BIGINT EXTRACT(timeinteravlunit FROM temporal)

入参说明

参数名	数据类型	参数说明
timeinteravlunit	TIMEUNIT	需要从时间点或时间间隔中提取的时间单位，取值可以是：YEAR/QUARTER/MONTH/WEEK/DAY/DOY/HOUR/MINUTE/SECOND。
temporal	DATE/TIME/TIMESTAMP/INTERVAL	时间点或时间间隔。

不允许指定不存在于时间点或时间间隔中的时间单位，否则作业会提交失败。

例如如下错误语句，会报错YEAR不能从TIME中提取。

SELECT 
	EXTRACT(YEAR FROM TIME '12:44:31' ) AS `result`
FROM
	testtable;

示例

测试语句

SELECT 
	EXTRACT(YEAR FROM DATE '1997-04-25' ) AS `result`,
        EXTRACT(MINUTE FROM TIME '12:44:31') AS `result2`,
        EXTRACT(SECOND FROM TIMESTAMP '1997-04-25 13:14:15') AS `result3`,
        EXTRACT(YEAR FROM INTERVAL '2-10' YEAR TO MONTH) AS `result4`,
FROM
	testtable;

测试结果

result	result2	result3	result4
1997	44	15	2

YEAR

功能描述
从SQL日期date返回年份，以BIGINT类型返回。
语法说明
```
BIGINT YEAR(date)
```

入参说明

参数名	数据类型	参数说明
date	DATE	DATE类型的SQL日期。

示例

测试语句

SELECT 
	YEAR(DATE '1997-04-25' ) AS `result`
FROM
	testtable;

测试结果

result

1997

result
1997

QUARTER

功能描述
从SQL日期返回表示该日期季度的数字（1到4之间的整数），返回类型为BIGINT。
语法说明
```
BIGINT QUARTER(date)
```

入参说明

参数名	数据类型	参数说明
date	DATE	SQL日期。

示例

测试语句

SELECT 
	QUARTER(DATE '1997-04-25' ) AS `result`
FROM
	testtable;

测试结果

result

2

result
2

MONTH

功能描述
返回输入时间的月份（1到12之间的整数），返回类型为BIGINT。
语法说明
```
BIGINT MONTH(date)
```

入参说明

参数名	数据类型	参数说明
date	DATE	SQL日期。

示例

测试语句

SELECT 
	MONTH(DATE '1997-04-25' ) AS `result`
FROM
	testtable;

测试结果

result

4

result
4

WEEK

功能描述
计算当前日期是一年中的第几周，以BIGINT类型返回。
语法说明
```
BIGINT WEEK(date)
```

入参说明

参数名	数据类型	参数说明
date	DATE	SQL日期。

示例

测试语句

SELECT 
	WEEK(DATE '1997-04-25' ) AS `result`
FROM
	testtable;

测试结果

result

17

result
17

DAYOFYEAR

功能描述
计算当前日期是一年中的第几天（返回1到366 之间的整数），以BIGINT类型返回。
语法说明
```
BIGINT DAYOFYEAR(date)
```

入参说明

参数名	数据类型	参数说明
date	DATE	SQL日期。

示例

测试语句

SELECT 
	DAYOFYEAR(DATE '1997-04-25' ) AS `result`
FROM
	testtable;

测试结果

result

115

result
115

DAYOFMONTH

功能描述
计算当前日期是这个月的第几天（1到31之间的整数），以BIGINT类型返回。
语法说明
```
BIGINT DAYOFMONTH(date)
```

入参说明

参数名	数据类型	参数说明
date	DATE	SQL日期。

示例

测试语句

SELECT 
	DAYOFMONTH(DATE '1997-04-25' ) AS `result`
FROM
	testtable;

测试结果

result

25

result
25

DAYOFWEEK

功能描述
计算当前日期是当前周的第几天（1 到 7之间的整数），以BIGINT类型返回。

需要注意这里自然周的起点是星期天，即每周的第1天是星期天，第2天是星期一，以此类推。
语法说明
```
BIGINT DAYOFWEEK(date)
```

入参说明

参数名	数据类型	参数说明
date	DATE	SQL日期。

示例

测试语句

SELECT 
	DAYOFWEEK(DATE '1997-04-25') AS `result`
FROM
	testtable;

测试结果

result

6

result
6

HOUR

功能描述
从当前时间戳获取以24小时制的小时数进行返回，范围0-23（0 到 23 之间的整数），返回类型为BIGINT。
语法说明
```
BIGINT HOUR(timestamp)
```

入参说明

参数名	数据类型	参数说明
timestamp	TIMESTAMP	SQL时间戳。

示例

测试语句

SELECT 
	HOUR(TIMESTAMP '1997-04-25 10:11:12') AS `result`
FROM
	testtable;

测试结果

result

10

result
10

MINUTE

功能描述
返回当前时间戳中的分钟数（0 到 59 之间的整数），返回类型为BIGINT。
语法说明
```
BIGINT MINUTE(timestamp)
```

入参说明

参数名	数据类型	参数说明
timestamp	TIMESTAMP	SQL时间戳。

示例

测试语句

SELECT 
	MINUTE(TIMESTAMP '1997-04-25 10:11:12') AS `result`
FROM
	testtable;

测试结果

result

11

result
11

SECOND

功能描述
返回当前时间戳中的秒数（0 到 59 之间的整数），返回类型为BIGINT。
语法说明
```
BIGINT SECOND(timestamp)
```

入参说明

参数名	数据类型	参数说明
timestamp	TIMESTAMP	SQL时间戳。

示例

测试语句

SELECT 
	SECOND(TIMESTAMP '1997-04-25 10:11:12') AS `result`
FROM
	testtable;

测试结果

result

12

result
12

FLOOR

功能描述
返回将时间点向下取值到指定时间单位的值。

语法说明

TIME/TIMESTAMP(3) FLOOR(timepoint TO timeintervalunit)

入参说明

参数名	数据类型	参数说明
timepoint	TIMESTAMP/TIME	SQL时间或SQL时间戳。
timeintervalunit	TIMEUNIT	时间单位，类型可以是YEAR/QUARTER/MONTH/WEEK/DAY/DOY/HOUR/MINUTE/SECOND。

示例

测试语句。

SELECT 
	FLOOR(TIME '13:14:15' TO MINUTE) AS `result`
        FLOOR(TIMESTAMP '1997-04-25 13:14:15' TO MINUTE) AS `result2`,
        FLOOR(TIMESTAMP '1997-04-25 13:14:15' TO MINUTE) AS `result3`
FROM	testtable;

测试结果

message	message2	message3
13:14	13:14	1997-04-25T13:14

CEIL

功能描述
返回将时间点向上取值到指定时间单位的值。

语法说明

TIME/TIMESTAMP(3) CEIL(timepoint TO timeintervalunit)

入参说明

参数名	数据类型	参数说明
timepoint	TIMESTAMP/TIME	SQL时间或SQL时间戳。
timeintervalunit	TIMEUNIT	时间单位，类型可以是YEAR/QUARTER/MONTH/WEEK/DAY/DOY/HOUR/MINUTE/SECOND。

示例

测试语句。

SELECT 
	CEIL(TIME '13:14:15' TO MINUTE) AS `result`
        CEIL(TIMESTAMP '1997-04-25 13:14:15' TO MINUTE) AS `result2`,
        CEIL(TIMESTAMP '1997-04-25 13:14:15' TO MINUTE) AS `result3`
FROM	testtable;

测试结果

result	result2	result3
13:15	13:15	1997-04-25T13:15

OVERLAPS

功能描述
如果两个时间范围有重叠，则返回TRUE，反之，则返回FALSE。

语法说明

BOOLEAN (timepoint1, temporal1) OVERLAPS (timepoint2, temporal2)

入参说明

参数名	数据类型	参数说明
timepoint1/timepoint2	DATE/TIME/TIMESTAMP	时间点。
temporal1/temporal2	DATE/TIME/TIMESTAMP/INTERVAL	时间点或时间间隔。

(timepoint, temporal)在判断是否重叠时为闭区间。
temporal可以是DATE/TIME/TIMESTAMP也可以是INTERVAL。
- 当temporal是DATE/TIME/TIMESTAMP时，(timepoint, temporal)表示timepoint, temporal之间的时间间隔。允许temporal在timepoint之前，如(DATE '1997-04-25', DATE '1997-04-23')也合法。
- 当temporal是INTERVAL时，(timepoint, temporal)表示timepoint, timepoint+temporal之间的时间间隔。
必须保证(timepoint1, temporal1)和(timepoint2, temporal2)是同一数据类型的时间间隔。

示例

测试语句

SELECT 
	(TIME '2:55:00', INTERVAL '1' HOUR) OVERLAPS (TIME '3:30:00', INTERVAL '2' HOUR) AS `result`,
        (TIME '2:30:00', INTERVAL '1' HOUR) OVERLAPS (TIME '3:30:00', INTERVAL '2' HOUR) AS `result2`,
	(TIME '2:30:00', INTERVAL '1' HOUR) OVERLAPS (TIME '3:31:00', INTERVAL '2' HOUR) AS `result3`,
	(TIME '9:00:00', TIME '10:00:00') OVERLAPS (TIME '10:00:00', INTERVAL '3' HOUR) AS `result4`,
	(TIMESTAMP '1997-04-25 12:00:00', TIMESTAMP '1997-04-25 12:20:00') OVERLAPS (TIMESTAMP '1997-04-25 13:00:00', INTERVAL '2' HOUR) AS `result5`,
	(DATE '1997-04-23', INTERVAL '2' DAY) OVERLAPS (DATE '1997-04-25', INTERVAL '2' DAY) AS `result6`,
	(DATE '1997-04-25', DATE '1997-04-23') OVERLAPS (DATE '1997-04-25', INTERVAL '2' DAY) AS `result7`
FROM
	testtable;

测试结果

result	result2	result3	result4	result5	result6	result7
true	true	false	true	false	true	true

DATE_FORMAT

功能描述
将时间戳或时间戳格式的字符串转换为指定格式的日期字符串。

语法说明

STRING DATE_FORMAT(timestamp, dateformat)

入参说明

参数名	数据类型	参数说明
timestamp	TIMESTAMP/STRING	时间点。
dateformat	STRING	日期格式字符串。

示例

测试语句

SELECT 
	DATE_FORMAT(TIMESTAMP '1997-04-25 10:11:12', 'yyyy-MM-dd HH:mm:ss') AS `result`,
        DATE_FORMAT(TIMESTAMP '1997-04-25 10:11:12', 'yyyy-MM-dd') AS `result2`,
	DATE_FORMAT(TIMESTAMP '1997-04-25 10:11:12', 'yy/MM/dd HH:mm') AS `result3`,
        DATE_FORMAT('1997-04-25 10:11:12', 'yyyy-MM-dd') AS `result4`
FROM	testtable;

测试结果

result	result2	result3	result4
1997-04-25 10:11:12	1997-04-25	97/04/25 10:11	1997-04-25

TIMESTAMPADD

功能描述
参考语法说明，本函数功能为将整型interval与timeintervalunit组成的结果添加到timepoint中，并返回添加后的日期时间。

TIMESTAMPADD函数返回结果与timepoint相同。例外场景为：如果timepoint输入类型为TIMESTAMP，也可以将TIMESTAMPADD函数返回结果插入到DATE类型的表字段中。

语法说明

TIMESTAMP(3)/DATE/TIME TIMESTAMPADD(timeintervalunit, interval, timepoint)

入参说明

参数名	数据类型	参数说明
timeintervalunit	TIMEUNIT	时间单位。
interval	INT	整型的时间间隔。
timepoint	TIMESTAMP/DATE/TIME	时间点

示例

测试语句

SELECT 
	TIMESTAMPADD(WEEK, 1, DATE '1997-04-25') AS `result`,
        TIMESTAMPADD(QUARTER, 1, TIMESTAMP '1997-04-25 10:11:12') AS `result2`,
	TIMESTAMPADD(SECOND, 2, TIME '10:11:12') AS `result3`
FROM	testtable;

测试结果

result	result2	result3
1997-05-02	如果该字段插入到TIMESTAMP类型的表字段中，则返回：1997-07-25T10:11:12 如果该字段插入到TIMESTAMP类型的表字段中，则返回：1997-07-25	10:11:14

result

result2

result3

1997-05-02

如果该字段插入到TIMESTAMP类型的表字段中，则返回：1997-07-25T10:11:12

如果该字段插入到TIMESTAMP类型的表字段中，则返回：1997-07-25

10:11:14

TIMESTAMPDIFF

功能描述
参考语法说明，本函数功能为返回timepoint1和timepoint2之间的时间间隔，间隔的单位由第一个参数timepointunit指定。

语法说明

INT TIMESTAMPDIFF(timepointunit, timepoint1, timepoint2)

入参说明

参数名	数据类型	参数说明
timepointunit	TIMEUNIT	时间单位。取值范围为： SECOND、MINUTE、HOUR、DAY、MONTH、YEAR。
timepoint1/timepoint2	TIMESTAMP/DATE	时间点。

示例

测试语句

SELECT 
	TIMESTAMPDIFF(DAY, TIMESTAMP '1997-04-25 10:00:00', TIMESTAMP '1997-04-28 10:00:00') AS `result`,
        TIMESTAMPDIFF(DAY, DATE '1997-04-25', DATE '1997-04-28') AS `result2`,
	TIMESTAMPDIFF(DAY, TIMESTAMP '1997-04-27 10:00:20', TIMESTAMP '1997-04-25 10:00:00') AS `result3`
FROM	testtable;

测试结果

result	result2	result3
3	3	-2

CONVERT_TZ

功能描述
参考语法说明，本函数将日期时间string1（具有默认ISO时间戳格式'yyyy-MM-dd HH:mm:ss' ）从时区string2转换为时区string3的值，结果以STRING类型返回。

语法说明

STRING CONVERT_TZ(string1, string2, string3)

入参说明

参数名	数据类型	参数说明
string1	STRING	SQL时间戳形式的字符串，不符合格式的字符串会返回NULL。
string2	STRING	转换前时区。时区的格式应该是缩写如“PST”，全名如“Country A/City A”，或自定义ID如“GMT-08:00”。
string3	STRING	转换后时区。时区的格式应该是缩写如“PST”，全名如“Country A/City A”，或自定义ID如“GMT-08:00”。

示例

测试语句

SELECT 
	CONVERT_TZ(1970-01-01 00:00:00, UTC, Country A/City A) AS `result`,
        CONVERT_TZ(1997-04-25 10:00:00, UTC, GMT-08:00) AS `result2`
FROM	testtable;

测试结果

result	result2
1969-12-31 16:00:00	1997-04-25 02:00:00

FROM_UNIXTIME

功能描述
参考语法说明，本函数根据时间戳numeric和当前时区返回string格式的时间。
语法说明
```
STRING FROM_UNIXTIME(numeric[, string])
```

入参说明

参数名	数据类型	参数说明
numeric	BIGINT	内部时间戳值，表示自'1970-01-01 00:00:00' UTC 以来的秒数，值可以由UNIX_TIMESTAMP() 函数生成。
string	STRING	时间字符串格式。如果该参数不指定，则默认为'yyyy-MM-dd HH:mm:ss'。

示例

测试语句

SELECT 
	FROM_UNIXTIME(44) AS `result`,
        FROM_UNIXTIME(44, 'yyyy:MM:dd') AS `result2`
FROM	testtable;

测试结果

result	result2
1970-01-01 08:00:44	1970:01:01

UNIX_TIMESTAMP

功能描述
以秒为单位获取当前的Unix时间戳。以BIGINT类型返回。
语法说明
```
BIGINT UNIX_TIMESTAMP()
```
入参说明
无。

示例

测试语句

SELECT 
	UNIX_TIMESTAMP() AS `result`
FROM
	table;

测试结果

result

1635401982

UNIX_TIMESTAMP(string1[, string2])

功能描述
参数语法说明，本函数将以string2格式的时间字符串string1转为Unix 时间戳（以秒为单位）。以BIGINT类型返回。

语法说明

BIGINT UNIX_TIMESTAMP(string1[, string2])

入参说明

参数名	数据类型	参数说明
string1	STRING	SQL时间戳形式的字符串。不符合string2参数格式的字符串语法会报错。
string2	STRING	时间字符串格式。如果不指定该参数，则默认为'yyyy-MM-dd HH:mm:ss' 。

示例

测试语句

SELECT 
	UNIX_TIMESTAMP('1997-04-25', 'yyyy-MM-dd') AS `result`,
        UNIX_TIMESTAMP('1997-04-25 00:00:10', 'yyyy-MM-dd HH:mm:ss') AS `result2`,
        UNIX_TIMESTAMP('1997-04-25 00:00:00') AS `result3`
FROM
	testtable;

测试结果

result	result2	result3
861897600	861897610	861897600

TO_DATE

功能描述
参数语法说明，本函数将string2格式的日期字符串string1转换为DATE类型。
语法说明
```
DATE TO_DATE(string1[, string2])
```

入参说明

参数名	数据类型	参数说明
string1	STRING	SQL时间戳形式的字符串。不符合格式的字符串会执行报错。
string2	STRING	字符串格式。如果不指定该参数，则默认为'yyyy-MM-dd' 。

示例

测试语句

SELECT 
	TO_DATE('1997-04-25') AS `result`,
        TO_DATE('1997:04:25', 'yyyy-MM-dd') AS `result2`,
        TO_DATE('1997-04-25 00:00:00', 'yyyy-MM-dd HH:mm:ss') AS `result3`
FROM
	testtable;

测试结果

result	result2	result3
1997-04-25	1997-04-25	1997-04-25

TO_TIMESTAMP

功能描述
将string2格式的日期时间字符串string1转换为TIMESTAMP类型返回。

语法说明

TIMESTAMP TO_TIMESTAMP(string1[, string2])

入参说明

参数名	数据类型	参数说明
string1	STRING	SQL时间戳形式的字符串。不符合格式的字符串会返回NULL。
string2	STRING	日期字符串格式。如果该参数不指定，则默认为'yyyy-MM-dd HH:mm:ss' 。

示例

测试语句

SELECT 
	TO_TIMESTAMP('1997-04-25', 'yyyy-MM-dd') AS `result`,
        TO_TIMESTAMP('1997-04-25 00:00:00') AS `result2`,
        TO_TIMESTAMP('1997-04-25 00:00:00', 'yyyy-MM-dd HH:mm:ss') AS `result3`
FROM
	testtable;

测试结果

result	result2	result3
1997-04-25 00:00	1997-04-25 00:00	1997-04-25 00:00

时间函数

函数说明

DATE

DATE_ADD

DATE_SUB

TIME

TIMESTAMP

INTERVAL

CURRENT_DATE

CURRENT_TIME

CURRENT_TIMESTAMP

LOCALTIME

LOCALTIMESTAMP

EXTRACT

YEAR

QUARTER

MONTH

WEEK

DAYOFYEAR

DAYOFMONTH

DAYOFWEEK

HOUR

MINUTE

SECOND

FLOOR

CEIL

OVERLAPS

DATE_FORMAT

TIMESTAMPADD

TIMESTAMPDIFF

CONVERT_TZ

FROM_UNIXTIME

UNIX_TIMESTAMP

UNIX_TIMESTAMP(string1[, string2])

TO_DATE

TO_TIMESTAMP

相关文档

意见反馈

文档内容是否对您有帮助？