MariaDBでは、SUBDATE()
は、特定の日付から金額を差し引く組み込みの日付と時刻の関数です。
日付、減算する単位、および減算する量を指定することにより、日付を変更できます。 追加するために負の金額を渡すことができます 日付から引くのではなく、日付まで。
SUBDATE()
減算する日数を指定できるショートカット構文もあります。
構文
SUBDATE()
関数には2つの構文があります。
構文1:
SUBDATE(expr,days)
expr
は日付で、days
減算する日数です。
構文2:
SUBDATE(date,INTERVAL expr unit)
date
変更する日付、expr
は減算する量であり、unit
減算する日付/時刻の単位です(秒、分など)。
この構文を使用する場合、SUBDATE()
DATE_SUB()
の同義語です 。
例–構文1
最初の構文の使用例は次のとおりです。
SELECT SUBDATE('2021-05-01', 1);
結果:
+--------------------------+ | SUBDATE('2021-05-01', 1) | +--------------------------+ | 2021-04-30 | +--------------------------+
必要に応じて時間部分を含めることもできます:
SELECT SUBDATE('2021-05-01 10:00:00', 1);
結果:
+-----------------------------------+ | SUBDATE('2021-05-01 10:00:00', 1) | +-----------------------------------+ | 2021-04-30 10:00:00 | +-----------------------------------+
同じことを行う2つの代替方法を次に示します。
SELECT
DATE_SUB('2021-05-01 10:00:00', INTERVAL 1 DAY) AS "Result 1",
'2021-05-01 10:00:00' - INTERVAL 1 DAY AS "Result 2";
結果:
+---------------------+---------------------+ | Result 1 | Result 2 | +---------------------+---------------------+ | 2021-04-30 10:00:00 | 2021-04-30 10:00:00 | +---------------------+---------------------+
例–構文2
2番目の構文の使用例は次のとおりです。
SELECT SUBDATE('2021-05-31 10:00:00', INTERVAL 1 HOUR);
結果:
+-------------------------------------------------+ | SUBDATE('2021-05-31 10:00:00', INTERVAL 1 HOUR) | +-------------------------------------------------+ | 2021-05-31 09:00:00 | +-------------------------------------------------+
この構文により、日付から他の単位を減算できます(つまり、日だけではありません)。ここでは、日付から1時間を減算しましたが、分、秒、月、日、年などを簡単に減算することもできます。後で例を示します。
上記の例と同じ結果を達成するための2つの代替方法を次に示します。
SELECT
DATE_SUB('2021-05-31 10:00:00', INTERVAL 1 HOUR) AS "Result 1",
'2021-05-31 10:00:00' - INTERVAL 1 HOUR AS "Result 2";
結果:
+---------------------+---------------------+ | Result 1 | Result 2 | +---------------------+---------------------+ | 2021-05-31 09:00:00 | 2021-05-31 09:00:00 | +---------------------+---------------------+
負の間隔
負の間隔を指定すると追加 その金額は日付になります。
例:
SELECT SUBDATE('2021-05-31 10:00:00', INTERVAL -1 HOUR);
結果:
+--------------------------------------------------+ | SUBDATE('2021-05-31 10:00:00', INTERVAL -1 HOUR) | +--------------------------------------------------+ | 2021-05-31 11:00:00 | +--------------------------------------------------+
その他のユニット
さまざまな日付と時刻の単位から1の間隔を差し引く例を次に示します。
SELECT
SUBDATE('2021-05-01 10:00:00', INTERVAL 1 YEAR) AS YEAR,
SUBDATE('2021-05-01 10:00:00', INTERVAL 1 MONTH) AS MONTH,
SUBDATE('2021-05-01 10:00:00', INTERVAL 1 DAY) AS DAY,
SUBDATE('2021-05-01 10:00:00', INTERVAL 1 HOUR) AS HOUR,
SUBDATE('2021-05-01 10:00:00', INTERVAL 1 MINUTE) AS MINUTE,
SUBDATE('2021-05-01 10:00:00', INTERVAL 1 SECOND) AS SECOND,
SUBDATE('2021-05-01 10:00:00', INTERVAL 1 MICROSECOND) AS MICROSECOND;
結果(垂直出力を使用):
YEAR: 2020-05-01 10:00:00 MONTH: 2021-04-01 10:00:00 DAY: 2021-04-30 10:00:00 HOUR: 2021-05-01 09:00:00 MINUTE: 2021-05-01 09:59:00 SECOND: 2021-05-01 09:59:59 MICROSECOND: 2021-05-01 09:59:59.999999
複合ユニット
複合ユニットを使用する例を次に示します。
SELECT
SUBDATE('2021-05-01 10:00:00', INTERVAL '1:2' YEAR_MONTH) AS "YEAR_MONTH",
SUBDATE('2021-05-01 10:00:00', INTERVAL '1:25:35' HOUR_SECOND) AS "HOUR_SECOND",
SUBDATE('2021-05-01 10:00:00', INTERVAL '1:30' DAY_MINUTE) AS "DAY_MINUTE";
結果:
+---------------------+---------------------+---------------------+ | YEAR_MONTH | HOUR_SECOND | DAY_MINUTE | +---------------------+---------------------+---------------------+ | 2020-03-01 10:00:00 | 2021-05-01 08:34:25 | 2021-05-01 08:30:00 | +---------------------+---------------------+---------------------+
ヌル日付
null
を渡す 日付の場合はnull
を返します :
SELECT SUBDATE(null, INTERVAL 1 YEAR);
結果:
+--------------------------------+ | SUBDATE(null, INTERVAL 1 YEAR) | +--------------------------------+ | NULL | +--------------------------------+
引数がありません
SUBDATE()
を呼び出す 引数の数が間違っているか、引数を渡さないと、エラーが発生します:
SELECT SUBDATE();
結果:
ERROR 1064 (42000): You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use near ')' at line 1