EXTRACT
説明
EXTRACT関数は、年、月、週、日、時、分、秒などの特定の時間コンポーネントを日付または時刻値から抽出するために使用されます。この関数は、日時の特定の部分を正確に取得することができます。
この関数は、MySQLのextract functionとほぼ一貫した動作をします。違いは、Dorisが現在、以下のような複合単位入力をサポートしていないことです：
mysql> SELECT EXTRACT(YEAR_MONTH FROM '2019-07-02 01:02:03');
-> 201907
構文
EXTRACT(<unit> FROM <date_or_time_expr>)
パラメータ
| パラメータ | 説明 |
|---|---|
<unit> | DATETIMEから指定された単位の値を抽出します。単位はyear、month、week、day、hour、minute、second、またはmicrosecondを指定できます |
<datetime_or_time_expr> | date/datetimeタイプおよび日付時刻フォーマットの文字列をサポートする有効な日付式。具体的なdatetimeおよびdateフォーマットについては、datetime conversionおよびdate conversionを参照してください |
戻り値
抽出された単位に応じて、日付または時刻の抽出された部分をINT型で返します。
week単位の値範囲は0-53で、以下のように計算されます：
- 日曜日が週の最初の日です。
- 年の最初の日曜日を含む週が第1週です。
- 最初の日曜日より前の日付は第0週に属します。
単位がyear、month、day、hour、minute、second、microsecondの場合、datetimeの対応する単位値を返します。
単位がquarterの場合、1月-3月は1、4月-6月は2、7月-9月は3、10月-12月は4を返します。
特殊なケース：
<date_or_time_expr>がNULLの場合、NULLを返します。
例
-- Extract year, month, day, hour, minute, second, microsecond time components from datetime
select extract(year from '2022-09-22 17:01:30') as year,
extract(month from '2022-09-22 17:01:30') as month,
extract(day from '2022-09-22 17:01:30') as day,
extract(hour from '2022-09-22 17:01:30') as hour,
extract(minute from '2022-09-22 17:01:30') as minute,
extract(second from '2022-09-22 17:01:30') as second,
extract(microsecond from cast('2022-09-22 17:01:30.000123' as datetime(6))) as microsecond;
+------+-------+------+------+--------+--------+-------------+
| year | month | day | hour | minute | second | microsecond |
+------+-------+------+------+--------+--------+-------------+
| 2022 | 9 | 22 | 17 | 1 | 30 | 123 |
+------+-------+------+------+--------+--------+-------------+
-- Extract quarter from datetime
mysql> select extract(quarter from '2023-05-15') as quarter;
+---------+
| quarter |
+---------+
| 2 |
+---------+
-- Extract week number for the corresponding date. Since the first Sunday of 2024 is on January 7th, all dates before 01-07 return 0
select extract(week from '2024-01-06') as week;
+------+
| week |
+------+
| 0 |
+------+
-- January 7th is the first Sunday, returns 1
select extract(week from '2024-01-07') as week;
+------+
| week |
+------+
| 1 |
+------+
-- Under this rule, 2024 only has weeks 0-52
select extract(week from '2024-12-31') as week;
+------+
| week |
+------+
| 52 |
+------+
-- Input unit does not exist, reports error
select extract(uint from '2024-01-07') as week;
ERROR 1105 (HY000): errCode = 2, detailMessage = Can not found function 'uint'