8.5. Types date/heure

type [ (p) ] 'valeur'

Le Tableau 8.10, « Saisie de date » montre les formats de date possibles pour les entrées de type date.

Les types heure-du-jour sont time [ (p) ] without time zone et time [ (p) ] with time zone. Écrire juste time est équivalent à time without time zone

Les valeurs d'entrée valides pour ces types sont constituées d'une heure du jour suivi d'un fuseau horaire optionnel (voir le Tableau 8.11, « Saisie d'heure » et le Tableau 8.12, « Saisie des zones de date »). Si un fuseau est précisé pour le type time without time zone, il est ignoré sans message d'erreur.

Référez-vous à l'Annexe B, Support de date/heure pour une liste de noms de fuseaux horaire reconnus en entrée.

Les valeurs d'entrée valides sont constituées par la concaténation d'une date, d'une heure, suivi d'un fuseau horaire optionnel, d'un qualificatif optionnel AD (avant Jésus Christ) ou BC (après Jésus Christ). (Autrement, AD/BC peut apparaître avant le fuseau horaire mais ce n'est pas l'ordre préféré.) Ainsi :

1999-01-08 04:05:06

et

1999-01-08 04:05:06 -8:00

sont des valeurs valides, qui suivent le standard ISO 8601. De plus, le format

January 8 04:05:06 1999 PST

très courant, est supporté.

Le standard SQL différencie les littéraux timestamp without time zone et timestamp with time zone par la présence d'un « + » ou d'un « - ». Du coup, suivant le standard,

TIMESTAMP '2004-10-19 10:23:54'

est du type timestamp without time zone alors que

TIMESTAMP '2004-10-19 10:23:54+02'

est du type timestamp with time zone. PostgreSQL™ n'examine jamais le contenu d'une chaîne littérale avant de déterminer son type. Du coup, il ne traitera les deux ci-dessus comme des valeurs de type timestamp without time zone. Pour s'assurer qu'un littéral est traité comme une valeur de type timestamp with time zone, donnez-lui explicitement le bon type :

TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02'

Dans un littéral de type timestamp without time zone, PostgreSQL™ ignorera silencieusement toute indication de fuseau horaire. C'est-à-dire que la valeur résultante est dérivée des champs date/time dans la valeur en entrée et n'est pas ajustée pour le fuseau horaire.

Pour timestamp with time zone, la valeur stockée en interne est toujours en UTC (Temps Universel Coordonné), aussi connu sous le nom de GMT. Les valeurs d'entrée qui ont un fuseau horaire explicite sont converties en UTC en utilisant le décalage approprié. Si aucun fuseau horaire n'est précisé, alors le système considère que la date est dans le fuseau horaire indiqué par le paramètre système timezone, et la convertit en UTC en utilisant le décalage de la zone timezone.

Quand une valeur timestamp with time zone est affichée, elle est toujours convertie de l'UTC vers le fuseau horaire courant (variable timezone), et affichée comme une heure locale de cette zone. Pour voir l'heure dans un autre fuseau horaire, il faut soit changer la valeur de timezone ou utiliser la construction AT TIME ZONE (voir la Section 9.9.3, « AT TIME ZONE »).

Les conversions entre timestamp without time zone et timestamp with time zone considèrent normalement que la valeur timestamp without time zone utilise le fuseau horaire timezone. Une zone différente peut être choisie en utilisant AT TIME ZONE.

Les valeurs de type interval utilisent la syntaxe suivante:

[@] quantité unité [quantité unité...] [direction]

Où: quantité est un nombre (éventuellement signé) ; unité est microsecond, millisecond, second, minute, hour, day, week, month, year, decade, century, millennium, ou des abréviations ou des pluriels de ces unités ; direction peut être ago ou vide. L'arobase (@) est optionnel. Les valeurs des différentes unités sont implicitement ajoutées en utilisant le signe approprié.

Les quantités de jours, heures, minutes et secondes peuvent être précisées sans unité explicite. Par exemple '1 12:59:10' est compris de la même façon que '1 day 12 hours 59 min 10 sec' (1 jour, 12 heures, 59 minutes, 10 secondes).

La précision optionnelle, en dessous de la seconde, doit être entre 0 et 6, et prend la précision du littéral comme valeur par défaut.

En interne, les valeurs interval sont enregistrées comme des mois, jours et secondes. Ceci est fait car le nombre de jours d'un mois varie et qu'un jour peut avoir 23 ou 25 heures si le changement d'heure s'applique. Comme les intervalles sont habituellement créés à partir de chaînes de caractères constantes ou de soustraction timestamp subtraction, cette méthode de stockage fonctionne bien dans la majorité des cas. Les fonctions justify_days et justify_hours sont disponibles pour ajuster les jours et les heures qui dépassent leurs périodes habituelles.

PostgreSQL™ supporte aussi plusieurs valeurs de dates spéciales, par simplicité, comme montré dans le Tableau 8.13, « Saisie de dates/heures spéciales ». Les valeurs infinity et -infinity ont une représentation spéciale dans le système et seront affichées de la même façon. Les autres sont simplement des facilités de notation qui seront converties en dates/heures ordinaires lorsqu'elles seront lues (en particulier, now et les chaînes relatives sont converties en une valeur temps spécifique dès qu'elles sont lues). Toutes ces valeurs sont traitées comme des constantes normales, et doivent être écrites entre apostrophes.

Les fonctions suivantes, compatibles avec le standard SQL, peuvent aussi être utilisées pour obtenir l'heure courante pour le type de données correspondant : CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, LOCALTIME, LOCALTIMESTAMP. Les quatre derniers acceptent une spécification de la précision en dessous de la seconde en option (voir la Section 9.9.4, « Date/Heure courante »). Notez néanmoins que ce sont des fonctions SQL et qu'elles ne sont pas reconnues en tant que chaînes en entrée de la donnée.