月

説明

MONTH関数は、datetime値から月の値を抽出します。戻り値は1から12の範囲で、年の12か月を表します。この関数はDATEおよびDATETIME型の処理をサポートしています。

この関数は、MONTHを単位として使用する場合、MySQLのmonth functionと一致しています。

構文

MONTH(`<date_or_time_expr>`)

Parameters

Parameter	Description
<date_or_time_expr>	入力される日時の値。date/datetimeタイプをサポートします。具体的なdatetimeとdateの形式については、datetime conversionおよびdate conversionを参照してください。

Return Value

TINYINTタイプの値を返し、月の値を表します：

• 範囲：1から12
• 1は1月、12は12月を表します
• 入力がNULLの場合、NULLを返します

Examples

-- Extract month from DATE type
SELECT MONTH('1987-01-01') AS result;
+--------+
| result |
+--------+
|      1 |
+--------+

-- Extract month from DATETIME type
SELECT MONTH('2023-07-13 22:28:18') AS result;
+--------+
| result |
+--------+
|      7 |
+--------+

-- Extract month from DATETIME with fractional seconds
SELECT MONTH('2023-12-05 10:15:30.456789') AS result;
+--------+
| result |
+--------+
|     12 |
+--------+

-- Returns NULL when input is NULL
SELECT MONTH(NULL) AS result;
+--------+
| result |
+--------+
| NULL   |
+--------+