日期和时间函数和运算符

日期和时间运算符

时区转换

AT TIME ZONE运算符设置时间戳的时区：

SELECT timestamp '2012-10-31 01:00 UTC';
2012-10-31 01:00:00.000 UTC
SELECT timestamp '2012-10-31 01:00 UTC' AT TIME ZONE 'America/Los_Angeles';
2012-10-30 18:00:00.000 America/Los_Angeles

日期和时间函数

current_date -> date

返回查询开始时的当前日期。

current_time -> time with time zone

返回查询开始时的当前时间。

current_timestamp -> timestamp with time zone

返回查询开始时的当前时间戳。

current_timezone() -> varchar

以IANA定义的格式（如America/Los_Angeles）或相对于UTC的固定偏移量（如+08:35）返回当前时区。

date(x) -> date

这是CAST(x AS date)的别名。

from_iso8601_timestamp(string) -> timestamp with time zone

将以ISO 8601格式表示的string解析为timestamp with time zone。

from_iso8601_date(string) -> date

将以ISO 8601格式表示的string解析为date。

from_unixtime(unixtime) -> timestamp

将UNIX时间戳unixtime作为时间戳返回。unixtime是从1970-01-01 00:00:00开始经历的秒数。

from_unixtime(unixtime, string) -> timestamp with time zone

将UNIX时间戳unixtime作为timestamp with time zone返回，其中使用string作为时区。unixtime是从1970-01-01 00:00:00开始经历的秒数。

from_unixtime(unixtime, hours, minutes) -> timestamp with time zone

将UNIX时间戳unixtime作为timestamp with time zone返回，其中使用hours和minutes作为时区偏移量。unixtime是从1970-01-01 00:00:00开始经历的秒数。

localtime -> time

返回查询开始时的当前时间。

localtimestamp -> timestamp

返回查询开始时的当前时间戳。

now() -> timestamp with time zone

这是current_timestamp的别名。

to_iso8601(x) -> varchar

将x格式化为ISO 8601字符串。x可以是date、timestamp或timestamp with time zone。

to_milliseconds(interval) -> bigint

以毫秒为单位返回以天和秒为单位的间隔interval。

to_unixtime(timestamp) -> double

将timestamp作为UNIX时间戳返回。

注意

以下SQL标准函数不使用括号：

• current_date
• current_time
• current_timestamp
• localtime
• localtimestamp

截断函数

date_trunc函数支持以下单位：

上面的示例使用时间戳2001-08-22 03:04:05.321作为输入。

date_trunc(unit, x) -> [与输入相同]

返回x截断至unit后的值。

间隔函数

该部分中的函数支持以下间隔单位：

date_add(unit, value, timestamp) -> [与输入相同]

向timestamp添加类型为unit的间隔value。可以使用负值做减法。

date_diff(unit, timestamp1, timestamp2) -> bigint

以unit为单位返回timestamp2 - timestamp1的值。

持续时间函数

parse_duration函数支持以下单位：

parse_duration(string) -> interval

将格式为value unit的string解析为一个间隔，其中value是以unit为单位的小数值。

SELECT parse_duration('42.8ms'); -- 0 00:00:00.043
SELECT parse_duration('3.81 d'); -- 3 19:26:24.000
SELECT parse_duration('5m');     -- 0 00:05:00.000

MySQL日期函数

该部分中的函数使用与MySQL date_parse和str_to_date函数兼容的格式字符串。下表根据MySQL手册说明了格式说明符：

警告

当前不支持以下说明符：%D %U %u %V %w %X

date_format(timestamp, format) -> varchar

使用format将timestamp格式化为一个字符串。

date_parse(string, format) -> timestamp

使用format将string解析为一个时间戳。

Java日期函数

该部分中的函数使用与Joda-Time的DateTimeFormat模式格式兼容的格式字符串。

format_datetime(timestamp, format) -> varchar

使用format将timestamp格式化为一个字符串。

parse_datetime(string, format) -> timestamp with time zone

使用format将string格式化为一个timestamp with time zone。

提取函数

extract函数支持以下字段：

extract函数支持的类型因要提取的字段而异。大多数字段都支持所有日期和时间类型。

extract(field FROM x) -> bigint

从x返回field。

注意

该SQL标准函数使用特殊的语法来指定参数。

便捷提取函数

DAY

day(x) -> bigint

从x返回一个月中的第几日。

DAY OF MONTH

day_of_month(x) -> bigint

这是day的别名。

DAY OF WEEK

day_of_week(x) -> bigint

从x返回星期几(ISO)。值的范围为1（星期一）至7（星期日）。

DAY OF YEAR

day_of_year(x) -> bigint

从x返回一年中的第几日。值的范围为1至366。

DOW

dow(x) -> bigint

这是day_of_week的别名。

DOY

doy(x) -> bigint

这是day_of_year的别名。

HOUR

hour(x) -> bigint

从x返回一天中的第几个小时。值的范围为0至23。

MILLISECOND

millisecond(x) -> bigint

从x返回一秒中的第几个毫秒。

MINUTE

minute(x) -> bigint

从x返回一小时中的第几分钟。

MONTH

month(x) -> bigint

从x返回一年中的某个月份。

QUARTER

quarter(x) -> bigint

从x返回一年中的某个季度。值的范围为1至4。

SECOND

second(x) -> bigint

从x返回一分中的第几秒。

TIMEZONE HOURS

timezone_hour(timestamp) -> bigint

从timestamp返回时区偏移量的小时数。

TIMEZONE MINUTE

timezone_minute(timestamp) -> bigint

从timestamp返回时区偏移量的分钟数。

WEEK

week(x) -> bigint

从x返回一年中的第几周(ISO)。值的范围为1至53。

WEEK OF YEAR

week_of_year(x) -> bigint

这是week的别名。

YEAR

year(x) -> bigint

从x返回年份。

YEAR OF WEEK

year_of_week(x) -> bigint

从x返回ISO周的年份。

YOW

yow(x) -> bigint

这是year_of_week的别名。