Curso de MariaDB / Armazenar datas e horas com DATE, DATETIME e TIMESTAMP

DATE guarda uma data, DATETIME guarda campos de calendário com data e hora, e TIMESTAMP representa um momento convertido conforme a zona horária da conexão. Decida se precisa de um horário local de calendário ou do instante de um evento: a mesma entrada TIMESTAMP pode ser exibida de maneira diferente em sessões distintas.

Distinguir data, horário local e instante

Tipo Finalidade de exemplo Comportamento de zona horária
DATE Aniversário ou data de reserva Não guarda por si uma hora ou identidade de zona
DATETIME Campos como 2026-10-13 09:00:00 Alterar somente a zona da sessão não converte o valor
TIMESTAMP Evento registrado ou recebido Converte entre zona da sessão e UTC na entrada e na saída

UTC é o Tempo Universal Coordenado, uma referência comum para comparar instantes. O deslocamento +09:00 da Coreia significa que 09:00 nesse local e 00:00 UTC na mesma data representam o mesmo instante. Acrescentar as letras UTC a uma cadeia não configura a conexão.

Um DATETIME local não preserva por si as regras de zona e horário de verão de uma região. Conforme a finalidade, a aplicação pode normalizar para UTC ou guardar campos locais junto de um identificador de zona. TIMESTAMP também não conserva o nome da zona original da entrada.

Conferir versão e zona da conexão

Conecte como course_user ao servidor de práticas com shopcourse disponível. O guia do cliente e dos arquivos SQL explica conexão e SOURCE. Execute dentro da conexão, não no shell:

SELECT VERSION() AS server_version, DATABASE() AS selected_database;
USE shopcourse;
SELECT DATABASE() AS selected_database;

O banco selecionado deve ser shopcourse. Salve o exemplo normal completo em um arquivo .sql UTF-8 e use SOURCE com o caminho local real. Mantenha falhas intencionais fora desse arquivo. Confira também os valores de zona:

SELECT @@SESSION.time_zone AS session_zone,
       @@GLOBAL.time_zone AS global_zone,
       @@system_time_zone AS system_zone;

SESSION é a conexão atual; o valor global fornece um padrão para novas conexões. SYSTEM usa a zona do sistema operacional do servidor, portanto a localização física da máquina não comprova a configuração efetiva da conexão. A prática usa +09:00 e +00:00 explícitos e não precisa de tabelas de zonas nomeadas.

No modo SQL normal, DATE e DATETIME admitem anos de 1000 a 9999. O limite superior de TIMESTAMP depende da versão: antes do MariaDB 11.5, termina em 2038-01-19 03:14:07 UTC; desde 11.5, em 2106-02-07 06:28:15 UTC. O limite inferior ordinário é 1970-01-01 00:00:01 UTC, separado dos valores especiais zero. Compare SELECT VERSION() com a faixa TIMESTAMP por versão. Pacotes da distribuição e do fornecedor podem diferir.

Inserir uma vez e mudar apenas a zona da sessão

Confirme que time_lab ainda não exista ou examine seu estado antes de criar. O exemplo insere os mesmos campos em DATETIME e TIMESTAMP e depois altera uma condição: a zona da sessão. Guarda os ajustes originais antes de mudar. TIMESTAMP NULL DEFAULT NULL evita depender dos padrões implícitos da primeira coluna TIMESTAMP, que variam conforme versão e configuração. O guia de definição de tabelas explica a importância de conferir a estrutura real.

USE shopcourse;
SET @saved_sql_mode = @@SESSION.sql_mode;
SET SESSION sql_mode = 'STRICT_TRANS_TABLES';
SET @saved_time_zone = @@SESSION.time_zone;
SET SESSION time_zone = '+09:00';
CREATE TABLE time_lab (
  item_id INT PRIMARY KEY,
  event_date DATE NOT NULL,
  wall_time DATETIME NOT NULL,
  instant_time TIMESTAMP NULL DEFAULT NULL
) ENGINE=InnoDB;
INSERT INTO time_lab VALUES
  (1, '2026-10-13', '2026-10-13 09:00:00', '2026-10-13 09:00:00');
SELECT item_id, event_date, wall_time, instant_time FROM time_lab;
SET SESSION time_zone = '+00:00';
SELECT item_id, event_date, wall_time, instant_time FROM time_lab;
SET SESSION time_zone = '+09:00';
SELECT item_id, wall_time, instant_time FROM time_lab;
Zona da consulta event_date wall_time instant_time
+09:00 após inserir 2026-10-13 2026-10-13 09:00:00 2026-10-13 09:00:00
+00:00 2026-10-13 2026-10-13 09:00:00 2026-10-13 00:00:00
+09:00 restabelecido 2026-10-13 2026-10-13 09:00:00 2026-10-13 09:00:00

A coluna TIMESTAMP não se tornou dois eventos distintos. O mesmo instante é exibido para dois deslocamentos da conexão; DATETIME mantém os campos de calendário. Consulte a definição DATETIME e as regras de conversão TIMESTAMP ao escolher o comportamento necessário.

Definir valores automáticos e frações de segundo

Declare DEFAULT CURRENT_TIMESTAMP quando a coluna deve receber automaticamente o horário de criação. ON UPDATE CURRENT_TIMESTAMP é outra escolha para atualização automática. Uma coluna de última alteração não representa necessariamente o momento em que um evento externo realmente aconteceu.

DATETIME(6) e TIMESTAMP(6) definem até seis casas fracionárias de segundo. O 6 não é uma faixa de anos ou o tamanho total do texto. Alinhe deliberadamente a precisão da coluna e da expressão padrão; nem todo registro precisa de microssegundos.

Use formatos claros como YYYY-MM-DD e YYYY-MM-DD HH:MM:SS. Cadeias locais como 10/11/26, ou datas armazenadas como texto arbitrário, tornam conversão e comparação mais difíceis. A referência DATE apresenta formato, faixa e particularidades de modo SQL, incluindo a compatibilidade ORACLE.

Diagnosticar datas inválidas e deslocamentos inesperados

Depois do arquivo normal, execute a falha abaixo separadamente na mesma conexão em modo estrito. Não existe 30 de fevereiro:

INSERT INTO time_lab VALUES (2, '2026-02-30', '2026-10-13 09:00:00', NULL);

Espere Incorrect date value e confira que time_lab continua com uma linha. Modos SQL afetam datas inválidas e valores zero; mudar o modo apenas para contornar um erro pode alterar o significado dos dados. A documentação dos modos SQL descreve as condições.

Se uma consulta apresentar nove horas de diferença, examine primeiro o tipo da coluna e @@SESSION.time_zone. Antes de somar ou subtrair nove horas com UPDATE, confira se aplicação e conexão estão convertendo o valor duas vezes.

Um deslocamento fixo não representa todo o histórico de horário de verão de uma região. Zonas nomeadas exigem dados de zona adequados no servidor e uma política da aplicação. Esta prática demonstra apenas a conversão com deslocamentos fixos.

Restaurar os ajustes originais da conexão

SET SESSION time_zone = @saved_time_zone;
SET SESSION sql_mode = @saved_sql_mode;
SELECT @@SESSION.time_zone, @@SESSION.sql_mode;

Restaure na mesma conexão que guardou as variáveis. Se desconectou, elas já não contêm os valores originais; examine a nova sessão em vez de aplicar variáveis vazias.

Antes de repetir, confira SELECT DATABASE() e SHOW CREATE TABLE time_lab para confirmar que o destino é a tabela prescindível criada aqui. Copie os dados necessários e somente depois remova-a:

DROP TABLE shopcourse.time_lab;

DROP TABLE remove estrutura e linhas e não é desfeito por ROLLBACK comum. Depois é possível executar o exemplo normal novamente. A tabela products da primeira prática de produtos permanece fora desta reinicialização.