quarter

説明

日付の四半期部分を返します。範囲は1から4です。

構文

INT quarter(DATETIME|DATE date);

パラメータ

date: DATETIME または DATE 型である必要があります。

戻り値

INT 値を返します。

次のいずれかのシナリオでは NULL が返されます:

• 日付が有効な DATETIME または DATE 値でない場合。

• 入力が空の場合。

• 日付が存在しない場合、例えば 2022-02-29。

例

例 1: DATETIME 値の四半期部分を返します。

SELECT QUARTER("2022-10-09 15:59:33");
+--------------------------------+
| quarter('2022-10-09 15:59:33') |
+--------------------------------+
|                              4 |
+--------------------------------+

例 2: DATE 値の四半期部分を返します。

SELECT QUARTER("2022-10-09");
+-----------------------+
| quarter('2022-10-09') |
+-----------------------+
|                     4 |
+-----------------------+

例 3: 現在の時刻または日付に対応する四半期部分を返します。

SELECT QUARTER(NOW());
+----------------+
| quarter(now()) |
+----------------+
|              4 |
+----------------+

SELECT QUARTER(CURDATE());
+--------------------+
| quarter(curdate()) |
+--------------------+
|                  4 |
+--------------------+