Formations — 1 037 leçons en français

Accueil › SQL & bases de données › Dates, heures et fuseaux

Dates, heures et fuseaux

Types et fonctionsintermediaire

Les dates concentrent une quantité surprenante de pièges. Trois règles évitent l'essentiel.

Stocker en timestamptz, afficher dans le fuseau du lecteur.

creee_le timestamptz NOT NULL DEFAULT now()

PostgreSQL normalise en UTC à l'écriture et réaffiche selon le paramètre timezone de la session. Une date de naissance, elle, se stocke en date — ce n'est pas un instant.

Filtrer par intervalle semi-ouvert, jamais par fonction.

-- ✗ index inutilisable
WHERE date(creee_le) = DATE '2026-09-21'

-- ✓ indexable, et le fuseau est explicite
WHERE creee_le >= TIMESTAMPTZ '2026-09-21 00:00+02'
  AND creee_le <  TIMESTAMPTZ '2026-09-22 00:00+02'

now() est figé pour la transaction. Deux appels renvoient la même valeur, ce qui garantit la cohérence entre plusieurs écritures. Pour mesurer une durée à l'intérieur d'un traitement, c'est clock_timestamp().

Enfin, méfiez-vous de l'arithmétique des mois : '2026-01-31' + INTERVAL '1 month' vaut 2026-02-28, et l'opération n'est pas réversible.

Les termes à connaître

now() / current_timestamp

L'instant du début de la transaction, pas de l'instruction. Deux appels dans une même transaction renvoient la même valeur — ce qui est souvent souhaitable, et parfois surprenant.

clock_timestamp()

L'heure réelle au moment de l'appel, qui avance pendant la transaction. À utiliser pour mesurer une durée à l'intérieur d'un traitement.

date_trunc

Ramène un instant au début de sa période : date_trunc('month', creee_le). La fonction de base de tout regroupement par jour, semaine ou mois.

AT TIME ZONE

Convertit entre timestamp et timestamptz. Appliqué à un timestamptz, il donne l'heure locale d'un fuseau ; appliqué à un timestamp, il l'interprète comme étant dans ce fuseau.

interval

Type représentant une durée : INTERVAL '1 day', INTERVAL '2 hours 30 minutes'. Attention, 1 month n'est pas une durée fixe — ajouter un mois au 31 janvier donne le 28 février.

age() et soustraction

fin - debut renvoie un interval exact ; age(fin, debut) renvoie une décomposition en années, mois et jours, plus lisible mais dépendante du calendrier.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.