MONTH

説明

MONTH 関数は日時値から月を抽出します。戻り値は 1 から 12 までで、年内の 12 か月を表します。この関数は DATE、DATETIME、TIMESTAMP_NS 型をサポートします。

MONTH を単位として使用する場合、この関数は MySQL の month 関数と同じ動作をします。

構文

MONTH(`<date_or_time_expr>`)

パラメータ

パラメータ	説明
<date_or_time_expr>	入力する日時値。DATE、DATETIME、TIMESTAMP_NS 型をサポートします。具体的な日時と日付の形式については、DATETIME の変換とDATE の変換を参照してください。

戻り値

月を表す TINYINT 型の値を返します。

• 範囲は 1 から 12 までです。
• 1 は年の最初の月、12 は年の最後の月を表します。
• 入力が NULL の場合は NULL を返します。

例

-- 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   |
+--------+