Curso de MariaDB / Calcular períodos, diferenças e formatos de datas
DATE_ADD soma um intervalo; DATEDIFF e TIMESTAMPDIFF calculam diferenças com regras distintas; DATE_FORMAT retorna texto para apresentar uma data. Diferencie dias de calendário de unidades decorridas e, para consultar um período completo, inclua seu início e exclua o início do período seguinte.
Definir a unidade e o significado do cálculo
Um vencimento daqui a um mês, a diferença entre datas do calendário e a quantidade de horas completas são perguntas diferentes. Calcule com tipos de data em vez de converter repetidamente textos de apresentação que dependem do idioma. O guia de DATE, DATETIME e TIMESTAMP explica o armazenamento e a influência do fuso horário da conexão.
| Função | Objetivo | Regra dos argumentos |
|---|---|---|
| DATE_ADD | Somar um intervalo | Por exemplo, INTERVAL 1 MONTH |
| DATEDIFF | Diferença entre as partes de data | Primeira data menos a segunda |
| TIMESTAMPDIFF | Diferença inteira em uma unidade | Segundo valor temporal menos o primeiro |
| DATE_FORMAT | Produzir texto de apresentação | Por exemplo, %Y-%m |
As referências oficiais de DATE_ADD, DATEDIFF, TIMESTAMPDIFF e DATE_FORMAT detalham suas condições.
Comparar entradas fixas na mesma conexão
Conecte como course_user ao servidor de aprendizado, execute USE shopcourse; e confira SELECT VERSION(), DATABASE(), @@SESSION.time_zone;. As datas fixas deixam o resultado independente do dia em que executar a prática. Escreva literais na ordem inequívoca ano-mês-dia.
Você pode salvar as consultas em um arquivo UTF-8 e executá-las com SOURCE e o caminho real, como explica o guia do cliente e dos arquivos SQL. Mantenha a seleção do banco e as consultas na mesma conexão. Execute as instruções dentro do cliente MariaDB.
SELECT DATE_ADD('2026-01-31',INTERVAL 1 MONTH);
SELECT DATE_ADD('2026-01-31',INTERVAL 30 DAY);
Um mês depois de 31 de janeiro é 2026-02-28; trinta dias depois é 2026-03-02. Um mês de calendário nem sempre equivale a trinta dias. Se o mês de destino não contém o dia original, o cálculo ajusta para seu último dia válido. Confira se esse ajuste atende à política de vencimento da aplicação.
Comparar a ordem dos argumentos e a parte de hora
SELECT DATEDIFF('2026-02-02 01:00:00','2026-02-01 23:00:00'),
TIMESTAMPDIFF(HOUR,'2026-02-01 23:00:00','2026-02-02 01:00:00');
Os resultados são um dia de calendário e duas horas completas. DATEDIFF ignora as horas e subtrai a segunda data da primeira. TIMESTAMPDIFF recebe primeiro a unidade, depois o início e, por último, o fim. Copiar mecanicamente a mesma ordem entre as funções pode inverter o sinal.
Uma diferença em unidades inteiras pode deixar de fora minutos ou segundos restantes. Para durações sensíveis a fusos e horário de verão, defina se os valores representam campos locais ou instantes normalizados. Dois valores DATETIME não codificam automaticamente o tempo real decorrido em todas as regiões.
Usar DATE_FORMAT para apresentar os dados
SELECT DATE_FORMAT('2026-02-05 12:34:56','%Y-%m'),
DATE_FORMAT('2026-02-05 12:34:56','%Y-%m-%d %H:%i:%s');
Os textos resultantes são 2026-02 e 2026-02-05 12:34:56. O marcador de minutos é %i; %m representa o mês. DATE_FORMAT altera a saída, preserva a data armazenada e retorna texto. Formatos com nomes de meses ou dias podem depender da configuração de idioma da sessão.
Consultar o mês inteiro com limite superior exclusivo
Use SHOW TABLES para conferir se dates_21_lab já existe. Se aparecer, examine definição e linhas antes de decidir se pode reiniciá-la. Trabalhe em uma instância de aprendizado sem dados de produção. O bloco seguinte contém a preparação completa e a consulta; execute com shopcourse selecionado. Ele independe das tabelas de produtos anteriores.
CREATE TABLE dates_21_lab (event_id INT PRIMARY KEY, occurred_at DATETIME NOT NULL)
ENGINE=InnoDB;
INSERT INTO dates_21_lab VALUES
(1,'2026-02-01 00:00:00'),(2,'2026-02-28 23:59:59'),(3,'2026-03-01 00:00:00');
SELECT event_id FROM dates_21_lab
WHERE occurred_at >= '2026-02-01' AND occurred_at < '2026-03-01'
ORDER BY event_id;
Os identificadores 1 e 2 são incluídos. O 3, exatamente à meia-noite de 1º de março, fica de fora. O início do mês seguinte continua sendo um limite claro quando a precisão de frações de segundo aumenta; escrever o último segundo do dia anterior poderia omitir registros com frações posteriores.
Comparações diretas de intervalo também deixam explícita a condição de acesso ao avaliar índices. Isso não garante um plano ou desempenho específico: depende dos dados, do índice e da consulta completa.
Examinar datas inválidas e repetir o exemplo
Se receber NULL ou avisos, confira formato, último dia do mês, regras de anos bissextos e modo SQL. Consulte SHOW WARNINGS imediatamente após a expressão investigada. Uma conversão aceita não torna datas incompletas ou zero válidas para o negócio. Defina o significado de uma entrada ausente antes de substituí-la pela data atual.
Antes de repetir, confirme o banco selecionado, examine SHOW CREATE TABLE shopcourse.dates_21_lab; e as linhas armazenadas e conserve o necessário. Remova somente a tabela prescindível desta prática. DROP TABLE remove definição e dados e não é desfeito por um ROLLBACK comum.
DROP TABLE shopcourse.dates_21_lab;




