Corso MariaDB / Memorizzare date e orari con DATE, DATETIME e TIMESTAMP
DATE conserva una data, DATETIME conserva i campi di data e ora del calendario e TIMESTAMP rappresenta un istante convertito secondo il fuso orario della connessione. Prima di scegliere il tipo, decidere se serve un'ora locale oppure l'istante di un evento: lo stesso input può produrre visualizzazioni TIMESTAMP diverse in sessioni differenti.
Distinguere data, ora locale e istante
| Tipo | Esempio d'uso | Comportamento del fuso orario |
|---|---|---|
| DATE | Compleanno o data di prenotazione | Non conserva da solo ora o identità di una zona oraria |
| DATETIME | Campi di calendario come 2026-10-13 09:00:00 | Cambiare soltanto il fuso della sessione non converte il valore |
| TIMESTAMP | Evento registrato o ricevuto | Converte tra fuso della sessione e UTC in scrittura e lettura |
Il Tempo Coordinato Universale, in inglese Coordinated Universal Time (UTC), è un riferimento comune per confrontare istanti. Con uno scostamento +09:00, le 09:00 locali e le 00:00 UTC della stessa data descrivono lo stesso istante. Aggiungere le lettere UTC a una stringa non configura il fuso della connessione al database.
Un valore DATETIME locale non conserva da solo l'identità della zona geografica o le regole dell'ora legale. Secondo lo scopo, l'applicazione può normalizzare a UTC oppure conservare campi locali insieme a un identificatore di zona. Neppure TIMESTAMP mantiene il nome della zona originaria dell'input.
Verificare versione del server e fuso della connessione
Collegarsi come course_user al server di studio con shopcourse disponibile. La guida al client e ai file SQL spiega collegamento e SOURCE. Eseguire i controlli dentro la connessione, non nella shell:
SELECT VERSION() AS server_version, DATABASE() AS selected_database;
USE shopcourse;
SELECT DATABASE() AS selected_database;
Il database selezionato deve essere shopcourse. Salvare l'esempio normale completo in un file UTF-8 .sql ed eseguirlo con SOURCE e il percorso locale reale. Tenere separati gli errori intenzionali perché possono interrompere il file. Usare un'istanza di studio senza dati di produzione.
SELECT @@SESSION.time_zone AS session_zone,
@@GLOBAL.time_zone AS global_zone,
@@system_time_zone AS system_zone;
SESSION riguarda la connessione corrente; l'impostazione globale fornisce il valore iniziale alle nuove connessioni. SYSTEM viene interpretato secondo il fuso del sistema operativo del server: non dedurre il valore effettivo dalla posizione geografica del computer. L'esercizio usa gli scostamenti espliciti +09:00 e +00:00 e non richiede tabelle dei fusi con nome.
L'intervallo normale degli anni di DATE e DATETIME va da 1000 a 9999. Il limite superiore di TIMESTAMP dipende dalla versione: prima di MariaDB 11.5 è 2038-01-19 03:14:07 UTC; dalla 11.5 è 2106-02-07 06:28:15 UTC. Il limite inferiore è 1970-01-01 00:00:01 UTC, distinto dai valori zero speciali. Confrontare SELECT VERSION() con i limiti TIMESTAMP della versione. Pacchetti di distribuzione e del produttore possono avere versioni diverse.
Inserire una volta e cambiare soltanto il fuso della sessione
L'esempio completo time_lab inserisce gli stessi campi di calendario in DATETIME e TIMESTAMP, poi cambia una sola impostazione: il fuso della sessione. Salva prima entrambi i valori di sessione. La dichiarazione esplicita TIMESTAMP NULL DEFAULT NULL evita di dipendere dai valori impliciti della prima colonna TIMESTAMP, variabili tra versioni e configurazioni. La guida alla definizione delle tabelle spiega il controllo della struttura memorizzata.
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;
| Fuso della query | event_date | wall_time | instant_time |
|---|---|---|---|
| +09:00 dopo INSERT | 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 ripristinato | 2026-10-13 | 2026-10-13 09:00:00 | 2026-10-13 09:00:00 |
La colonna TIMESTAMP non è diventata due eventi diversi: lo stesso istante viene visualizzato secondo due scostamenti della connessione. DATETIME mantiene i propri campi di calendario. Consultare la definizione DATETIME e le regole di conversione TIMESTAMP per scegliere il comportamento richiesto dall'applicazione.
Specificare valori automatici e frazioni di secondo
Usare esplicitamente DEFAULT CURRENT_TIMESTAMP quando una colonna deve ricevere automaticamente l'ora di creazione. ON UPDATE CURRENT_TIMESTAMP è una scelta separata per aggiornarla automaticamente quando cambia la riga. Una colonna di ultima modifica non indica automaticamente quando è avvenuto un evento esterno.
DATETIME(6) e TIMESTAMP(6) specificano fino a sei cifre frazionarie del secondo. Il 6 descrive la precisione inferiore al secondo, non l'intervallo degli anni o la lunghezza totale della stringa. Adeguare consapevolmente precisione della colonna ed espressione predefinita; non tutti i record richiedono microsecondi.
Usare formati non ambigui come YYYY-MM-DD e YYYY-MM-DD HH:MM:SS. Stringhe dipendenti dalle convenzioni locali come 10/11/26 o date conservate come testo arbitrario rendono conversioni e confronti difficili da valutare. Il riferimento DATE descrive formato e intervallo.
Diagnosticare date non valide e scostamenti inattesi
Dopo il file normale, eseguire questo errore intenzionale separatamente nella stessa connessione rigorosa. Il 30 febbraio non esiste:
INSERT INTO time_lab VALUES (2, '2026-02-30', '2026-10-13 09:00:00', NULL);
È atteso un errore Incorrect date value, con una sola riga ancora presente in time_lab. I modi SQL influiscono sulle date non valide e sui valori zero; cambiarli soltanto per aggirare un errore può alterare il significato dei dati. La documentazione dei modi SQL ne spiega le condizioni.
Se una query presenta una differenza inattesa di nove ore, controllare prima tipo della colonna e @@SESSION.time_zone. Prima di applicare un UPDATE che aggiunge o sottrae nove ore, verificare se applicazione e connessione stanno convertendo due volte lo stesso valore.
Uno scostamento fisso non rappresenta tutta la storia dell'ora legale di una regione. Le zone con nome richiedono dati appropriati sul server e una politica dell'applicazione. L'esercizio dimostra intenzionalmente soltanto la conversione tra scostamenti fissi.
Ripristinare le impostazioni originali della connessione
SET SESSION time_zone = @saved_time_zone;
SET SESSION sql_mode = @saved_sql_mode;
SELECT @@SESSION.time_zone, @@SESSION.sql_mode;
Ripristinare i valori nella stessa connessione che ha salvato le variabili. Dopo una disconnessione, le variabili non contengono più i valori originari: esaminare la nuova connessione invece di applicare una variabile salvata vuota.
Prima di ripetere, usare SELECT DATABASE() e SHOW CREATE TABLE time_lab per confermare la destinazione di studio. Salvare i dati da conservare. Solo dopo la verifica eliminare la tabella con:
DROP TABLE shopcourse.time_lab;
L'istruzione rimuove la tabella nominata e le righe. DROP TABLE non viene annullato da un normale ROLLBACK. Si può poi ripetere l'esempio normale completo. La tabella products della prima esercitazione sui prodotti resta fuori da questa reimpostazione.




