本节介绍用于检查和操作 TIME 值的函数和运算符。

时间运算符

下表显示了适用于 TIME 类型的所有数学运算符。

运算符	描述	示例	结果
+	添加 INTERVAL	TIME '01:02:03' + INTERVAL 5 HOUR	06:02:03
-	减去 INTERVAL	TIME '06:02:03' - INTERVAL 5 HOUR	01:02:03

时间函数

下表显示了适用于 TIME 类型的所有标量函数。

名称	描述
current_time	本地时区中的当前时间（当前事务的开始时间）。请注意，函数调用中应省略括号。
date_diff(part, starttime, endtime)	时间之间 分区 边界的数量。
date_part(part, time)	获取 子字段（等同于 extract）。
date_sub(part, starttime, endtime)	时间之间完整 分区 的数量。
datediff(part, starttime, endtime)	date_diff 的别名。时间之间 分区 边界的数量。
datepart(part, time)	date_part 的别名。获取 子字段（等同于 extract）。
datesub(part, starttime, endtime)	date_sub 的别名。时间之间完整 分区 的数量。
extract(part FROM time)	从时间中获取子字段。
get_current_time()	UTC 中的当前时间（当前事务的开始时间）。
make_time(bigint, bigint, double)	给定部分的对应时间。

为时间定义的唯一 日期部分 是 epoch、hours、minutes、seconds、milliseconds 和 microseconds。

current_time

描述	本地时区中的当前时间（当前事务的开始时间）。请注意，函数调用中应省略括号。
示例	current_time
结果	10:31:58.578
别名	get_current_time()

date_diff(part, starttime, endtime)

描述	时间之间 分区 边界的数量。
示例	date_diff('hour', TIME '01:02:03', TIME '06:01:03')
结果	5

date_part(part, time)

描述	获取 子字段（等同于 extract）。
示例	date_part('minute', TIME '14:21:13')
结果	21

date_sub(part, starttime, endtime)

描述	时间之间完整 分区 的数量。
示例	date_sub('hour', TIME '01:02:03', TIME '06:01:03')
结果	4

datediff(part, starttime, endtime)

描述	date_diff 的别名。时间之间 分区 边界的数量。
示例	datediff('hour', TIME '01:02:03', TIME '06:01:03')
结果	5

datepart(part, time)

描述	date_part 的别名。获取 子字段（等同于 extract）。
示例	datepart('minute', TIME '14:21:13')
结果	21

datesub(part, starttime, endtime)

描述	date_sub 的别名。时间之间完整 分区 的数量。
示例	datesub('hour', TIME '01:02:03', TIME '06:01:03')
结果	4

extract(part FROM time)

描述	从时间中获取子字段。
示例	extract('hour' FROM TIME '14:21:13')
结果	14

get_current_time()

描述	UTC 中的当前时间（当前事务的开始时间）。
示例	get_current_time()
结果	10:31:58.578
别名	current_time

make_time(bigint, bigint, double)

描述	给定部分的对应时间。
示例	make_time(13, 34, 27.123456)
结果	13:34:27.123456