Como ADDDATE() funciona no MariaDB

No MariaDB, ADDDATE() é uma função de data e hora integrada que executa aritmética de data.

Ele permite que você altere uma data especificando a data, a unidade a ser adicionada e o valor a ser adicionado. Você pode passar um valor negativo se precisar subtrair a data por um determinado intervalo.

ADDDATE() também possui uma sintaxe de atalho que permite adicionar um determinado número de dias à data.

Sintaxe

O ADDDATE() função tem duas sintaxes.

Sintaxe 1:

ADDDATE(expr,days)

Onde expr é a data e days é o número de dias a serem adicionados.

Sintaxe 2:

ADDDATE(date,INTERVAL expr unit)

Onde date é a data a ser alterada, expr é a quantidade a ser adicionada, e unit é a unidade a ser adicionada (por exemplo, segundo, minuto, etc).

Ao usar esta sintaxe, ADDDATE() é um sinônimo para DATE_ADD() .

Exemplo – Sintaxe 1

Aqui está um exemplo de uso da primeira sintaxe:

SELECT ADDDATE('2021-05-01', 1);

Resultado:

+--------------------------+| ADDDATE('2021-05-01', 1) |+--------------------------+| 02/05/2021 |+--------------------------+

Também podemos incluir a parte do tempo, se necessário:

SELECT ADDDATE('2021-05-01 10:00:00', 1);

Resultado:

+-----------------------------------+| ADDDATE('2021-05-01 10:00:00', 1) |+------------------------------------------ ----+| 2021-05-02 10:00:00 |+--------------------------------------------------+ 
 Aqui estão duas maneiras alternativas de fazer a mesma coisa:
 SELECT 
    DATE_ADD('2021-05-01 10:00:00', INTERVAL 1 DAY) AS "Result 1",
    '2021-05-01 10:00:00' + INTERVAL 1 DAY AS "Result 2"; 
 
 Resultado:
 +---------------------+----------+| Resultado 1 | Resultado 2 |+---------------------+---------------------+| 02-05-2021 10:00:00 | 2021-05-02 10:00:00 |+--------------------------------+---------------- -----+
 Exemplo – Sintaxe 2
 
 Aqui está um exemplo de uso da segunda sintaxe:
 SELECT ADDDATE('2021-05-31 10:00:00', INTERVAL 1 HOUR); 
 
 Resultado:
 +---------------------------------------------- ---+| ADDDATE('2021-05-31 10:00:00', INTERVAL 1 HOUR) |+----------------------------- --------------------+| 31/05/2021 11:00:00 |+------------------------------------------------- -----------+
 
 Essa sintaxe nos permite adicionar outras unidades à data (ou seja, não apenas os dias). Aqui, adicionei uma hora à data, mas poderia facilmente ter adicionado minutos, segundos, meses, dias, anos, etc. Continue lendo para obter exemplos. 
 
 Aqui estão dois métodos alternativos para alcançar o mesmo resultado do exemplo acima:
 SELECT 
    DATE_ADD('2021-05-31 10:00:00', INTERVAL 1 HOUR) AS "Result 1",
    '2021-05-31 10:00:00' + INTERVAL 1 HOUR AS "Result 2"; 
 
 Resultado:
 +---------------------+----------+| Resultado 1 | Resultado 2 |+---------------------+---------------------+| 31-05-2021 11:00:00 | 31/05/2021 11:00:00 |+--------------------------------+---------------- -----+
 Intervalos negativos
 
 Fornecer um intervalo negativo subtrai esse valor da data. 
 
 Exemplo:
 SELECT ADDDATE('2021-05-31 10:00:00', INTERVAL -1 HOUR); 
 
 Resultado:
 +---------------------------------------------- ----+| ADDDATE('2021-05-31 10:00:00', INTERVAL -1 HOUR) |+---------------------------- ------------+| 2021-05-31 09:00:00 |+------------------------------------------------- ------------+
 Outras Unidades
 
 Aqui está um exemplo que adiciona um intervalo de 1 às várias unidades de data e hora:
 SELECT 
    ADDDATE('2021-05-01 10:00:00', INTERVAL 1 YEAR) AS YEAR,
    ADDDATE('2021-05-01 10:00:00', INTERVAL 1 MONTH) AS MONTH,
    ADDDATE('2021-05-01 10:00:00', INTERVAL 1 DAY) AS DAY,
    ADDDATE('2021-05-01 10:00:00', INTERVAL 1 HOUR) AS HOUR,
    ADDDATE('2021-05-01 10:00:00', INTERVAL 1 MINUTE) AS MINUTE,
    ADDDATE('2021-05-01 10:00:00', INTERVAL 1 SECOND) AS SECOND,
    ADDDATE('2021-05-01 10:00:00', INTERVAL 1 MICROSECOND) AS MICROSECOND; 
 
 Resultado (usando saída vertical):
  ANO:2022-05-01 10:00:00 MÊS:2021-06-01 10:00:00 DIA:2021-05-02 10:00:00 HORA:2021-05-01 11:00:00 MINUTO:2021-05-01 10:01:00 SEGUNDO:2021-05-01 10:00:01 MICROSSEGUNDO:2021-05-01 10:00:00.000001
 Unidades Compostas
 
 Aqui está um exemplo que usa unidades compostas:
 SELECT 
    ADDDATE('2021-05-01 10:00:00', INTERVAL '1:2' YEAR_MONTH) AS "YEAR_MONTH",
    ADDDATE('2021-05-01 10:00:00', INTERVAL '1:25:35' HOUR_SECOND) AS "HOUR_SECOND",
    ADDDATE('2021-05-01 10:00:00', INTERVAL '1:30' DAY_MINUTE) AS "DAY_MINUTE"; 
 
 Resultado:
 +----------+---------------------+-- -------------------+| ANO_MÊS | HOUR_SECOND | DAY_MINUTE |+---------------------+---------------------+--- ------------------+| 01-07-2022 10:00:00 | 01-05-2021 11:25:35 | 01-05-2021 11:30:00 |+--------------------------------+---------------- -----+----------+
 Datas nulas
 
 Passando null para a data retorna null :
 SELECT ADDDATE(null, INTERVAL 1 YEAR); 
 
 Resultado:
 +--------------------------------+| ADDDATE(nulo, INTERVAL 1 ANO) |+--------------------------------+| NULL |+--------------------------------+
 Argumento ausente
 
 Chamando ADDDATE() com o número errado de argumentos ou sem passar nenhum argumento resulta em um erro:
 SELECT ADDDATE(); 
 
 Resultado:
 ERRO 1064 (42000):Você tem um erro em sua sintaxe SQL; verifique o manual que corresponde à sua versão do servidor MariaDB para a sintaxe correta para usar perto de ')' na linha 1