EXTRACT式

構文

extract_expression ::= EXTRACT "(" id FROM expression ")"

セマンティクス

EXTRACT式は、タイムスタンプからコンポーネントを抽出します。具体的には、FROMキーワードの後の式は、最大で1つのタイムスタンプまたはNULLを返す必要があります。この式の結果がNULLまたは空の場合、EXTRACTの結果もそれぞれNULLまたは空になります。それ以外場合は、そのidで指定されたコンポーネントが返されます。このidは、次のキーワードのいずれかである必要があります。

YEAR

タイムスタンプの年を-6383から9999の範囲で返します。

MONTH

タイムスタンプの月を1から12の範囲で返します。

DAY

タイムスタンプの月の日付を1から31の範囲で返します。

HOUR

タイムスタンプの時間を0から23の範囲で返します。

MINUTE

タイムスタンプの分を0から59の範囲で返します。

SECOND

タイムスタンプの秒を0から59の範囲で返します。

MILLISECOND

タイムスタンプの小数秒(ミリ秒)を0から999の範囲で返します。

MICROSECOND

タイムスタンプの小数秒(マイクロ秒)を0から999999の範囲で返します。

NANOSECOND

タイムスタンプの小数秒(ナノ秒)を0から999999999の範囲で返します。

WEEK

週が日曜日から始まり、最初の週にこの年の少なくとも1日が含まれる年内の週番号を1から54の範囲で返します。

ISOWEEK

IS0-8601に基づいて年内の週番号を返します。週は月曜日から始まり、最初の週はこの年の最低4日で、範囲は0から53です。

前述の各コンポーネントをタイムスタンプから抽出する特定の組込み関数があります。たとえば、EXTRACT(YEAR from expr)はyear(expr)と同等です。これらの関数および他の組込み関数については、組込み関数で説明しています。