日付と時刻の関数と演算子¶

日付と時刻の演算子¶

タイムゾーン変換¶

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 形式の文字列を解析し、タイムゾーン付きのタイムスタンプに変換します。

from_iso8601_date(string) -> date()¶

ISO 8601 形式の文字列を解析し、日付に変換します。

from_unixtime(unixtime) -> timestamp()¶

UNIX タイムスタンプ unixtime をタイムスタンプとして返します。

from_unixtime(unixtime, string) -> タイムゾーン付きのタイムスタンプ()¶

UNIX タイムスタンプ unixtime を、タイムゾーンに 文字列 を使用して、タイムゾーン付きタイムスタンプとして返します。

from_unixtime(unixtime, hours, minutes) -> タイムゾーン付きのタイムスタンプ()¶

UNIX タイムスタンプ unixtime を、タイムゾーンオフセットに hours と minutes を使用して、タイムゾーン付きタイムスタンプとして返します。

localtime -> time()¶

クエリの開始時点での現在の時刻を返します。

localtimestamp -> timestamp()¶

クエリの開始時点での現在のタイムスタンプを返します。

now() -> タイムゾーン付きのタイムスタンプ()¶

これは 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) -> [入力と同じ]()¶

x を unit に切り捨てて返します。

間隔関数¶

このセクションの関数は、以下の間隔単位をサポートします

date_add(unit, value, timestamp) -> [入力と同じ]()¶

unit 型の間隔 value を timestamp に加算します。減算は負の値を使用することで実行できます。

date_diff(unit, timestamp1, timestamp2) -> bigint()¶

timestamp2 - timestamp1 を unit で表現した値を返します。

期間関数¶

parse_duration 関数は以下の単位をサポートします

parse_duration(string) -> interval()¶

value unit 形式の 文字列 を解析して間隔に変換します。ここで 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()¶

timestampをformatを使用して文字列としてフォーマットします。

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

stringをformatを使用してタイムスタンプに解析します。

Java日付関数¶

このセクションの関数は、JodaTimeのDateTimeFormatパターン形式と互換性のある書式文字列を使用します。

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

timestampをformatを使用して文字列としてフォーマットします。

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

stringをformatを使用してタイムゾーン付きのタイムスタンプに解析します。

抽出関数¶

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() のエイリアスです。