メインコンテンツまでスキップ
バージョン: 26.x

HOURS_SUB

説明​

HOURS_SUB関数は、入力された日付またはdatetimeの値から指定された時間数を減算し、計算された新しいdatetimeを返します。この関数はDATEとDATETIMEの両方の入力タイプをサポートしています。入力がDATEタイプ（年、月、日のみを含む）の場合、時刻部分はデフォルトで00:00:00になります。

この関数は、HOUR単位を使用する場合のdate_sub functionおよびMySQLのdate_sub functionと一致しています。

構文​

HOURS_SUB(`<date_or_time_expr>`, `<hours>`)

パラメータ​

Parameterデスクリプション
<date_or_time_expr>date/datetimeタイプをサポートする有効な日付式。具体的なdatetimeおよびdate形式については、datetime conversionおよびdate conversionを参照してください
<hours>減算する時間数。INT型

戻り値​

指定された時間数を加算または減算した後のdatetimeを表すDATETIME型の値を返します（形式：YYYY-MM-DD HH:MM:SS）。

  • 計算結果がDATETIME型の有効範囲（0000-01-01 00:00:00から9999-12-31 23:59:59）を超える場合、エラーを返します。
  • 入力パラメータがNULLの場合、NULLを返します。
  • 入力時間数が負の場合、対応する時間数を加算したdatetimeを返します。

Examples​


-- Subtract positive hours
SELECT HOURS_SUB('2020-02-02 02:02:02', 1);
+------------------------------------------------------------+
| hours_sub(cast('2020-02-02 02:02:02' as DATETIMEV2(0)), 1) |
+------------------------------------------------------------+
| 2020-02-02 01:02:02                                        |
+------------------------------------------------------------+

-- Subtract hours from date type
select hours_sub('2023-10-01', 12);
+-----------------------------+
| hours_sub('2023-10-01', 12) |
+-----------------------------+
| 2023-09-30 12:00:00         |
+-----------------------------+

-- Input hours is negative, returns datetime plus hours
select hours_sub('2023-10-01 10:00:00', -3);
+--------------------------------------+
| hours_sub('2023-10-01 10:00:00', -3) |
+--------------------------------------+
| 2023-10-01 13:00:00                  |
+--------------------------------------+

-- Any parameter is NULL, return NULL
select hours_sub('2023-10-01 10:00:00', NULL);
+----------------------------------------+
| hours_sub('2023-10-01 10:00:00', NULL) |
+----------------------------------------+
| NULL                                   |
+----------------------------------------+

-- Exceeds datetime range, return NULL
mysql> select hours_sub('9999-12-31 12:00:00', -20);
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.2)[E-218]Operation hours_add of 9999-12-31 12:00:00, 20 out of range

mysql> select hours_sub('0000-01-01 12:00:00', 20);
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.2)[E-218]Operation hours_add of 0000-01-01 12:00:00, -20 out of range