日期和時間函數與運算子¶

日期和時間運算子¶

時區轉換¶

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) 的別名。

last_day_of_month(x) -> 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 作為時間戳記回傳。

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

將 UNIX 時間戳記 unixtime 作為帶時區的時間戳記回傳，並使用 string 作為時區。

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

將 UNIX 時間戳記 unixtime 作為帶時區的時間戳記回傳，並使用 hours 和 minutes 作為時區偏移量。

localtime -> time()¶

傳回查詢開始時的目前時間。

localtimestamp -> timestamp()¶

傳回查詢開始時的目前時間戳記。

now() -> timestamp with time zone()¶

這是 current_timestamp 的別名。

to_iso8601(x) -> varchar()¶

將 x 格式化為 ISO 8601 字串。x 可以是日期、時間戳記或帶時區的時間戳記。

to_milliseconds(interval) -> bigint()¶

將日到秒的 interval 作為毫秒回傳。

to_unixtime(timestamp) -> double()¶

將 timestamp 作為 UNIX 時間戳記回傳。

截斷函式¶

date_trunc 函式支援以下單位

以上範例使用時間戳記 2001-08-22 03:04:05.321 作為輸入。

date_trunc(unit, x) -> [same as input]()¶

回傳截斷為 unit 的 x。

間隔函式¶

此區段中的函式支援以下間隔單位

date_add(unit, value, timestamp) -> [same as input]()¶

將 unit 類型的間隔 value 加到 timestamp。可以使用負值執行減法。

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 手冊，描述了格式指定符

date_format(timestamp, format) -> varchar()¶

使用 format 將 timestamp 格式化為字串。

date_parse(string, format) -> timestamp()¶

使用 format 將 string 解析為時間戳記。

Java 日期函數¶

本節中的函數使用與 JodaTime 的 DateTimeFormat 模式格式相容的格式字串。

format_datetime(timestamp, format) -> varchar()¶

使用 format 將 timestamp 格式化為字串。

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

使用 format 將 string 解析為帶時區的時間戳記。

提取函數¶

extract 函數支援以下欄位

extract 函數支援的類型會根據要提取的欄位而有所不同。大多數欄位都支援所有日期和時間類型。

extract(field FROM x) -> bigint()¶

從 x 傳回 field。

注意

此 SQL 標準函數使用特殊語法來指定引數。

便利提取函數¶

day(x) -> bigint()¶

從 x 傳回月份中的日期。

day_of_month(x) -> bigint()¶

這是 day() 的別名。

day_of_week(x) -> bigint()¶

從 x 傳回 ISO 週中的日期。值範圍從 1 (星期一) 到 7 (星期日)。

day_of_year(x) -> bigint()¶

從 x 傳回一年中的日期。值範圍從 1 到 366。

dow(x) -> bigint()¶

這是 day_of_week() 的別名。

doy(x) -> bigint()¶

這是 day_of_year() 的別名。

hour(x) -> bigint()¶

從 x 傳回一天中的小時。值範圍從 0 到 23。

millisecond(x) -> bigint()¶

從 x 傳回秒的毫秒數。

minute(x) -> bigint()¶

從 x 傳回小時中的分鐘數。

month(x) -> bigint()¶

從 x 傳回一年中的月份。

quarter(x) -> bigint()¶

從 x 傳回一年中的季度。值範圍從 1 到 4。

second(x) -> bigint()¶

從 x 傳回分鐘中的秒數。

timezone_hour(timestamp) -> bigint()¶

從 timestamp 傳回時區偏移的小時數。

timezone_minute(timestamp) -> bigint()¶

從 timestamp 傳回時區偏移的分鐘數。

week(x) -> bigint()¶

從 x 傳回一年中的 ISO 週。值範圍從 1 到 53。

week_of_year(x) -> bigint()¶

這是 week() 的別名。

year(x) -> bigint()¶

從 x 傳回年份。

year_of_week(x) -> bigint()¶

從 x 傳回 ISO 週的年份。

yow(x) -> bigint()¶

這是 year_of_week() 的別名。