PostgreSQL a deux types d'horodatage. timestamptz (timestamp with time zone) stocke un instant exact : converti en UTC à la saisie, affiché dans le fuseau horaire de la session à la lecture. timestamp (timestamp without time zone) stocke une date et une heure d'horloge sans fuseau. Aucun des deux ne garde le fuseau que vous avez écrit. Pour tout ce qui s'est produit à un instant donné, utilisez timestamptz.
La même saisie donne 2026-03-01 12:00:00 et 2026-03-01 21:00:00+09. La valeur timestamptz désigne le même instant qu'avant, désormais affiché à l'heure de Tokyo. La valeur timestamp n'a pas de fuseau d'origine, donc elle ne bouge pas.
Ce que devient le fuseau horaire de la saisie
Quand la saisie contient un décalage, timestamptz s'en sert pour trouver l'instant. timestamp l'abandonne sans rien dire :
plain vaut 2026-03-01 12:00:00, le +02 a été jeté. with_zone vaut 2026-03-01 10:00:00+00, le même instant en UTC. C'est ainsi que des heures se retrouvent décalées : une application envoie une chaîne ISO avec un décalage dans une colonne timestamp, et le décalage disparaît.
Quand utiliser chacun
| Usage | Type |
|---|---|
| Création, mise à jour, paiement, connexion | timestamptz |
| Une heure locale planifiée qui suit l'horloge locale (« 9 h 00 chaque jour dans le fuseau de l'utilisateur ») | timestamp plus une colonne avec le nom du fuseau |
| Un jour du calendrier sans heure | date |
| Une durée | interval |
Les deux types prennent 8 octets et stockent les microsecondes. Réglez le fuseau de la session avec SET TIME ZONE 'Europe/Paris'. Utilisez les noms de fuseau complets, pas des abréviations comme EST : une abréviation est un décalage fixe qui ignore l'heure d'été.
Convertir entre fuseaux avec AT TIME ZONE
AT TIME ZONE fonctionne dans les deux sens. Sur un timestamptz, il renvoie l'heure d'horloge dans ce fuseau, sous forme de timestamp. Sur un timestamp, il lit la valeur comme une heure locale de ce fuseau et renvoie l'instant timestamptz correspondant.
Midi UTC correspond à 08:00 à New York en juillet, et 9 h 00 à Paris correspond à 07:00 UTC. Utilisez la première forme pour afficher une heure dans le fuseau de l'utilisateur, et la seconde pour transformer en instant une heure locale saisie par l'utilisateur.
Heure d'été et calculs sur les intervalles
Ajouter interval '1 day' à un timestamptz conserve la même heure locale à travers un changement d'heure. Ajouter '24 hours' ajoute des heures exactes. Aux États-Unis, les horloges avancent le 8 mars 2026 :
Le premier donne 2026-03-08 12:00:00-04, le second 2026-03-08 13:00:00-04. Le résultat dépend du fuseau horaire de la session, donc réglez-le explicitement dans le code qui fait des calculs de dates.
L'heure actuelle
now() et current_timestamp renvoient l'heure de début de la transaction en cours sous forme de timestamptz, la même valeur pour chaque ligne touchée par une instruction. clock_timestamp() renvoie l'heure réelle à chaque appel. current_date renvoie une date, et localtimestamp un timestamp. Une colonne typique est created_at timestamptz NOT NULL DEFAULT now().
Convertir une colonne timestamp en timestamptz
Si une colonne timestamp existante contient des heures UTC, convertissez-la avec USING ... AT TIME ZONE 'UTC', pour que les valeurs soient lues comme de l'UTC et non dans le fuseau de la session :
La valeur est maintenant 2026-01-15 09:30:00+01, affichée à l'heure de Berlin. La modification réécrit la table, donc lancez-la à un moment calme sur une grande table (ALTER TABLE couvre les changements de type). Les fonctions comme date_trunc, extract et age sont sur la page des fonctions de dates, et le chapitre sur les types date/heure détaille tous les formats de saisie.
Questions fréquentes
timestamptz stocke-t-il le fuseau horaire dans PostgreSQL ?
Non. Il convertit la saisie en UTC et ne stocke que cet instant. Le fuseau que vous avez écrit est perdu ; l'affichage suit le paramètre TimeZone de la session. Stockez le nom du fuseau dans une colonne text séparée si vous en avez besoin plus tard.
Quelle différence entre now() et clock_timestamp() ?
now() (identique à current_timestamp) renvoie l'heure de début de la transaction en cours, donc la même valeur pour chaque ligne et chaque instruction de cette transaction. clock_timestamp() renvoie l'heure réelle au moment de l'appel et change même au sein d'une seule instruction.
Comment obtenir la date du jour dans PostgreSQL ?
current_date renvoie la date du jour dans le fuseau horaire de la session. now()::date donne la même chose, et localtimestamp renvoie la date et l'heure actuelles sous forme de timestamp sans fuseau.
Quelle place prend un timestamp dans PostgreSQL ?
8 octets pour timestamp comme pour timestamptz, avec une précision à la microseconde. date prend 4 octets.