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.




