メインコンテンツまでスキップ
バージョン: Latest-3.4

hours_sub

指定された日時から指定された時間数を減算します。

Syntax​

DATETIME hours_sub(DATETIME|DATE date, INT hours);

Parameters​

  • date: 有効な DATE または DATETIME 式である必要があります。

  • hours: 減算する時間数。サポートされているデータ型は INT です。

Return value​

DATETIME 値を返します。日付が存在しない場合（例: 2022-21-01）、または日付が DATE または DATETIME 値でない場合、NULL が返されます。

Examples​

select hours_sub('2022-01-01 01:01:01', 1);
+-------------------------------------+
| hours_sub('2022-01-01 01:01:01', 1) |
+-------------------------------------+
| 2022-01-01 00:01:01                 |
+-------------------------------------+

select hours_sub('2022-01-01 01:01:01', -1);
+--------------------------------------+
| hours_sub('2022-01-01 01:01:01', -1) |
+--------------------------------------+
| 2022-01-01 02:01:01                  |
+--------------------------------------+

select hours_sub('2022-01-01', 1);
+----------------------------+
| hours_sub('2022-01-01', 1) |
+----------------------------+
| 2021-12-31 23:00:00        |
+----------------------------+

select hours_sub('2022-01-01', -1);
+-----------------------------+
| hours_sub('2022-01-01', -1) |
+-----------------------------+
| 2022-01-01 01:00:00         |
+-----------------------------+

Error case:
select hours_sub('2022-21-01', -1);
+--------------------------------------+
| hours_sub('2022-21-01', -1) |
+--------------------------------------+
| NULL                                 |
+--------------------------------------+