PostgreSQL ha due tipi timestamp. timestamptz (timestamp with time zone) memorizza un istante preciso: convertito in UTC in ingresso, mostrato nel fuso orario della sessione in uscita. timestamp (timestamp without time zone) memorizza una data e un orario da orologio a muro, senza fuso. Nessuno dei due conserva il fuso che hai scritto. Per tutto ciò che è successo in un certo momento, usa timestamptz.
Lo stesso input dà 2026-03-01 12:00:00 e 2026-03-01 21:00:00+09. Il valore timestamptz è lo stesso istante di prima, ora mostrato nell'ora di Tokyo. Il valore timestamp non ha un fuso da cui convertire, quindi non si sposta.
Cosa succede al fuso orario nell'input
Quando l'input porta un offset, timestamptz lo usa per trovare l'istante. timestamp lo scarta senza dire niente:
plain è 2026-03-01 12:00:00, con il +02 buttato via. with_zone è 2026-03-01 10:00:00+00, lo stesso istante in UTC. È così che gli orari finiscono sbagliati di qualche ora: un'applicazione invia una stringa ISO con un offset in una colonna timestamp, e l'offset sparisce.
Quando usare l'uno o l'altro
| Uso | Tipo |
|---|---|
| Creato, aggiornato, pagato, accesso effettuato | timestamptz |
| Un orario locale programmato che segue l'orologio locale ("alle 9:00 ogni giorno nel fuso dell'utente") | timestamp più una colonna con il nome del fuso |
| Un giorno del calendario senza orario | date |
| Una durata | interval |
Entrambi i tipi occupano 8 byte e memorizzano i microsecondi. Imposta il fuso della sessione con SET TIME ZONE 'Europe/Paris'. Usa i nomi completi dei fusi, non abbreviazioni come EST: un'abbreviazione è un offset fisso che ignora l'ora legale.
Convertire tra fusi con AT TIME ZONE
AT TIME ZONE funziona in entrambe le direzioni. Su un timestamptz restituisce l'orario da orologio a muro in quel fuso, come timestamp. Su un timestamp legge il valore come ora locale in quel fuso e restituisce l'istante timestamptz.
Mezzogiorno UTC sono le 08:00 a New York a luglio, e le 9:00 a Parigi sono le 07:00 UTC. Usa la prima forma per mostrare un orario nel fuso dell'utente, e la seconda per trasformare in un istante un'ora locale digitata dall'utente.
Ora legale e aritmetica con gli intervalli
Aggiungere interval '1 day' a un timestamptz mantiene lo stesso orario locale anche a cavallo del cambio dell'ora legale. Aggiungere '24 hours' aggiunge ore esatte. Negli Stati Uniti gli orologi vanno avanti l'8 marzo 2026:
Il primo dà 2026-03-08 12:00:00-04, il secondo 2026-03-08 13:00:00-04. Il risultato dipende dal fuso orario della sessione, quindi impostalo in modo esplicito nel codice che fa calcoli con le date.
Ora corrente
now() e current_timestamp restituiscono l'ora di inizio della transazione corrente come timestamptz, lo stesso valore per ogni riga toccata da un'istruzione. clock_timestamp() restituisce l'ora reale a ogni chiamata. current_date restituisce un date, e localtimestamp un timestamp. Una colonna tipica è created_at timestamptz NOT NULL DEFAULT now().
Convertire una colonna timestamp in timestamptz
Se una colonna timestamp esistente contiene orari UTC, convertila con USING ... AT TIME ZONE 'UTC', così i valori vengono letti come UTC e non nel fuso della sessione:
Il valore ora è 2026-01-15 09:30:00+01, mostrato nell'ora di Berlino. La modifica riscrive la tabella, quindi su una tabella grande eseguila in un momento tranquillo (ALTER TABLE copre i cambi di tipo). Funzioni come date_trunc, extract e age sono nella pagina sulle funzioni di data, e il capitolo sui tipi data e ora riporta tutti i formati di input.
Domande frequenti
timestamptz memorizza il fuso orario in PostgreSQL?
No. Converte l'input in UTC e memorizza solo quell'istante. Il fuso che hai scritto va perso; l'output viene mostrato secondo l'impostazione TimeZone della sessione. Se ti serve dopo, salva il nome del fuso in una colonna text separata.
Che differenza c'è tra now() e clock_timestamp()?
now() (uguale a current_timestamp) restituisce l'ora di inizio della transazione corrente, quindi resta uguale per ogni riga e istruzione al suo interno. clock_timestamp() restituisce l'ora effettiva nel momento della chiamata e cambia anche all'interno di una sola istruzione.
Come ottengo la data corrente in PostgreSQL?
current_date restituisce la data di oggi nel fuso orario della sessione. now()::date dà lo stesso risultato, e localtimestamp restituisce data e ora correnti come timestamp senza fuso.
Quanto spazio occupa un timestamp in PostgreSQL?
8 byte sia per timestamp sia per timestamptz, con risoluzione al microsecondo. date occupa 4 byte.