- カテゴリ:
YEAR* / DAY* / WEEK* / MONTH / QUARTER¶
日付またはタイムスタンプから対応する日付部分を抽出します。
これらの関数は、同等の日付部分で DATE_PART (または EXTRACT)関数を使用する代替手段です( サポートされている日付と時刻の部分 を参照)。
- こちらもご参照ください。
構文¶
YEAR( <date_or_timestamp_expr> )
YEAROFWEEK( <date_or_timestamp_expr> )
YEAROFWEEKISO( <date_or_timestamp_expr> )
DAY( <date_or_timestamp_expr> )
DAYOFMONTH( <date_or_timestamp_expr> )
DAYOFWEEK( <date_or_timestamp_expr> )
DAYOFWEEKISO( <date_or_timestamp_expr> )
DAYOFYEAR( <date_or_timestamp_expr> )
WEEK( <date_or_timestamp_expr> )
WEEKOFYEAR( <date_or_timestamp_expr> )
WEEKISO( <date_or_timestamp_expr> )
MONTH( <date_or_timestamp_expr> )
QUARTER( <date_or_timestamp_expr> )
引数¶
date_or_timestamp_expr
日付またはタイムスタンプ、または日付またはタイムスタンプに評価できる式。
戻り値¶
この関数は NUMBER型の値を返します。
使用上の注意¶
関数名 |
入力された日付またはタイムスタンプから抽出された日付部分 |
可能な値 |
---|---|---|
YEAR |
年 |
有効な年(例: 2025年) |
YEAROFWEEK [1] |
抽出された週が属する年 |
有効な年(例: 2025年) |
YEAROFWEEKISO |
ISO セマンティクス に基づいて、抽出された週が属する年 |
有効な年(例: 2025年) |
DAY , DAYOFMONTH |
月の日付(数値) |
1~31 |
DAYOFWEEK [1] |
週の日付(数値) |
0~7 |
DAYOFWEEKISO |
ISO セマンティクス に基づいた週の曜日(数値) |
1~7 |
DAYOFYEAR |
年の日付(数値) |
1~366 |
WEEK 、 WEEKOFYEAR [1] |
年の週(数値) |
1~54 |
WEEKISO |
ISO セマンティクス に基づいた年の週(数値) |
1~53 |
MONTH |
年の月(数値) |
1~12 |
QUARTER |
年の四半期(数値) |
1~4 |
[1] WEEK_OF_YEAR_POLICY および/または WEEK_START セッションパラメーターに設定された値によって示される結果です。
ISO セマンティクスとパラメーターの詳細については、 カレンダーの週と平日 をご参照ください。
例¶
以下の例は、関数 YEAR、 QUARTER、 MONTH、 DAY、 DAYOFWEEK、 DAYOFYEAR の使い方を示しています。
SELECT '2025-04-11T23:39:20.123-07:00'::TIMESTAMP AS tstamp,
YEAR(tstamp) AS "YEAR",
QUARTER(tstamp) AS "QUARTER OF YEAR",
MONTH(tstamp) AS "MONTH",
DAY(tstamp) AS "DAY",
DAYOFMONTH(tstamp) AS "DAY OF MONTH",
DAYOFYEAR(tstamp) AS "DAY OF YEAR";
+-------------------------+------+-----------------+-------+-----+--------------+-------------+
| TSTAMP | YEAR | QUARTER OF YEAR | MONTH | DAY | DAY OF MONTH | DAY OF YEAR |
|-------------------------+------+-----------------+-------+-----+--------------+-------------|
| 2025-04-11 23:39:20.123 | 2025 | 2 | 4 | 11 | 11 | 101 |
+-------------------------+------+-----------------+-------+-----+--------------+-------------+
以下の例は、関数 WEEK、 WEEKISO、 WEEKOFYEAR、 YEAROFWEEK、 YEAROFWEEKISO の使い方を示しています。セッションパラメーター WEEK_OF_YEAR_POLICY は 1
に設定され、その年の1月1日を含む週がその年の第1週となります。
ALTER SESSION SET WEEK_OF_YEAR_POLICY = 1;
SELECT '2016-01-02T23:39:20.123-07:00'::TIMESTAMP AS tstamp,
WEEK(tstamp) AS "WEEK",
WEEKISO(tstamp) AS "WEEK ISO",
WEEKOFYEAR(tstamp) AS "WEEK OF YEAR",
YEAROFWEEK(tstamp) AS "YEAR OF WEEK",
YEAROFWEEKISO(tstamp) AS "YEAR OF WEEK ISO";
+-------------------------+------+----------+--------------+--------------+------------------+
| TSTAMP | WEEK | WEEK ISO | WEEK OF YEAR | YEAR OF WEEK | YEAR OF WEEK ISO |
|-------------------------+------+----------+--------------+--------------+------------------|
| 2016-01-02 23:39:20.123 | 1 | 53 | 1 | 2016 | 2015 |
+-------------------------+------+----------+--------------+--------------+------------------+
以下の例は、関数 WEEK、 WEEKISO、 WEEKOFYEAR、 YEAROFWEEK、 YEAROFWEEKISO の使用法も示しています。セッションパラメーター WEEK_OF_YEAR_POLICY は、その年の最初の週が、その年の少なくとも4日を含む週であることを示すように設定されます。この例では、2015年12月27日から2016年1月2日までの週は、2016年の第1週ではなく、2015年の最終週とみなされます。この週には2016年1月1日(金)が含まれていますが、週の半分以下は2016年です。
ALTER SESSION SET WEEK_OF_YEAR_POLICY = 0;
SELECT '2016-01-02T23:39:20.123-07:00'::TIMESTAMP AS tstamp,
WEEK(tstamp) AS "WEEK",
WEEKISO(tstamp) AS "WEEK ISO",
WEEKOFYEAR(tstamp) AS "WEEK OF YEAR",
YEAROFWEEK(tstamp) AS "YEAR OF WEEK",
YEAROFWEEKISO(tstamp) AS "YEAR OF WEEK ISO";
+-------------------------+------+----------+--------------+--------------+------------------+
| TSTAMP | WEEK | WEEK ISO | WEEK OF YEAR | YEAR OF WEEK | YEAR OF WEEK ISO |
|-------------------------+------+----------+--------------+--------------+------------------|
| 2016-01-02 23:39:20.123 | 53 | 53 | 53 | 2015 | 2015 |
+-------------------------+------+----------+--------------+--------------+------------------+
次の例は、関数 DAYOFWEEK と DAYOFWEEKISO の使い方を示しています。セッションパラメーター WEEK_START は、週が日曜日に始まることを示すように設定されています。
ALTER SESSION SET WEEK_START = 7;
以下のクエリのタイムスタンプは、2025年4月5日(土曜日)のものです。DAYOFWEEK 関数は、週の最初の曜日が日曜日にセットされているため、土曜日の 7
を返します。ISO セマンティクスを使用する週の最初の曜日は月曜日であるため、 DAYOFWEEKISO 関数は 6
を返します。ISO セマンティクスと WEEK_START パラメーターの情報については、 カレンダーの週と平日 をご参照ください。
SELECT '2025-04-05T23:39:20.123-07:00'::TIMESTAMP AS tstamp,
DAYOFWEEK(tstamp) AS "DAY OF WEEK",
DAYOFWEEKISO(tstamp) AS "DAY OF WEEK ISO";
+-------------------------+-------------+-----------------+
| TSTAMP | DAY OF WEEK | DAY OF WEEK ISO |
|-------------------------+-------------+-----------------|
| 2025-04-05 23:39:20.123 | 7 | 6 |
+-------------------------+-------------+-----------------+
以下の例では、関数 DAYOFWEEK と DAYOFWEEKISO の使用例も示しています。セッションパラメーター WEEK_START は、週が月曜日に始まることを示すように設定されています。
ALTER SESSION SET WEEK_START = 1;
SELECT '2025-04-05T23:39:20.123-07:00'::TIMESTAMP AS tstamp,
DAYOFWEEK(tstamp) AS "DAY OF WEEK",
DAYOFWEEKISO(tstamp) AS "DAY OF WEEK ISO";
+-------------------------+-------------+-----------------+
| TSTAMP | DAY OF WEEK | DAY OF WEEK ISO |
|-------------------------+-------------+-----------------|
| 2025-04-05 23:39:20.123 | 6 | 6 |
+-------------------------+-------------+-----------------+
その他の例については、 日付と時刻の値の操作 をご参照ください。
週に関する関数(DAYOFWEEK、 WEEK、 WEEKOFYEAR、 YEAROFWEEK など)の詳細な例については、 カレンダーの週と平日 をご参照ください。