9.9. Fonctions et opérateurs pour date/heure

9.9.1. EXTRACT, date_part

EXTRACT (champ FROM
source)

La fonction extract récupère des sous-champs de valeurs date/heure, tels que l'année ou l'heure. source est une expression de valeur de type timestamp, time ou interval. (Les expressions de type date seront converties en timestamp et peuvent aussi être utilisées.) champ est un identifiant ou une chaîne qui sélectionne le champ à extraire de la valeur source. La fonction extract renvoie des valeurs de type double precision. Ce qui suit est une liste de noms de champs valides :

La fonction extract a pour but principal l'exécution de calcul. Pour le formatage des valeurs date/heure en affichage, voir Section 9.8.

La fonction date_part est modelé sur l'équivalent traditionnel Ingres de la fonction extract du standard SQL :

date_part('champ', source)

Notez, ici, que le paramètre champ doit être une valeur de type chaîne et non pas un nom. Les noms de champ valide pour date_part sont les mêmes que pour extract.

SELECT date_part('day', TIMESTAMP '2001-02-16 20:38:40');
Résultat : 16

SELECT date_part('hour', INTERVAL '4 hours 3 minutes');
Résultat : 4

9.9.2. date_trunc

La fonction date_trunc est conceptuellement similaire à la fonction trunc pour les nombres.

date_trunc('champ',
source)

source une expression de valeur de type timestamp ou interval. (Les valeurs de type date et time sont converties automatiquement en respectivement timestamp ou interval.) champ indique la précision pour tronquer la valeur en entrée. La valeur de retour est de type timestamp ou interval avec tous les champs qui sont moins signifiants que l'ensemble sélectionné de zéro (ou pour la date et le mois).

Les valeurs valides pour champ sont :

Exemples :

SELECT date_trunc('hour', TIMESTAMP '2001-02-16 20:38:40');
Résultat : 2001-02-16
20:00:00

SELECT date_trunc('year', TIMESTAMP '2001-02-16 20:38:40');
Résultat : 2001-01-01
00:00:00

9.9.3. AT TIME ZONE

La construction AT TIME ZONE permet les conversions du type << time stamps >> vers les différents fuseaux horaires. Tableau 9-27 affiche ses variantes.

Dans ces expressions, le fuseau horaire désiré zone peut être spécifié soit comme une chaîne texte (par exemple, 'PST') ou comme un intervalle (c'est-à-dire INTERVAL '-08:00'). Dans le cas textuel, les noms de fuseaux sont ceux affichés dans Tableau B-4. (Il pourrait être utile de supporter les noms plus généraux affichés dans Tableau B-6 mais ceci n'est pas encore implémenté.)

Exemples (supposant que la zone horaire locale est PST8PDT) :

SELECT TIMESTAMP '2001-02-16 20:38:40' AT TIME ZONE 'MST';
Résultat : 2001-02-16
19:38:40-08

SELECT TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40-05' AT TIME ZONE 'MST';
Résultat : 2001-02-16
18:38:40

Le premier exemple prend un << zone-less time stamp >> et l'interprète comme heure MST (UTC-7) pour produire un << time stamp >> UTC, qui effectue une rotation vers PST (UTC-8) pour l'affichage. Le deuxième exemple prend un type << time stamp >> spécifié en EST (UTC-5) et le convertit en l'heure locale en MST (UTC-7).

La fonction timezone(zone, timestamp) est équivalente pour la structure conforme au SQL timestamp AT TIME ZONE zone.

9.9.4. Date/Heure courante

Les fonctions suivantes sont disponibles pour obtenir la date courante et/ou l'heure :

CURRENT_DATE
CURRENT_TIME
CURRENT_TIMESTAMP
CURRENT_TIME ( precision )
CURRENT_TIMESTAMP ( precision )
LOCALTIME
LOCALTIMESTAMP
LOCALTIME ( precision )
LOCALTIMESTAMP ( precision )

CURRENT_TIME et CURRENT_TIMESTAMP délivrent les valeurs avec indication du fuseau horaire ; LOCALTIME et LOCALTIMESTAMP délivrent les valeurs avec indication du fuseau horaire.

CURRENT_TIME, CURRENT_TIMESTAMP, LOCALTIME, et LOCALTIMESTAMP peuvent se voir attribuer de façon optionnelle le paramètre de précision, qui cause l'arrondissement du résultat pour le nombre de chiffres de fraction dans le champ des secondes. Sans le paramètre de précision, le résultat est donné avec la précision complète.

Quelques exemples :

SELECT CURRENT_TIME;
Résultat :14:39:53.662522-05

SELECT CURRENT_DATE;
Résultat :2001-12-23

SELECT CURRENT_TIMESTAMP;
Résultat : 2001-12-23
14:39:53.662522-05

SELECT CURRENT_TIMESTAMP(2);
Résultat : 2001-12-23
14:39:53.66-05

SELECT LOCALTIMESTAMP;
Résultat : 2001-12-23
14:39:53.662522

La fonction now() est l'équivalent traditionnel PostgreSQL de CURRENT_TIMESTAMP.

Il existe aussi la fonction timeofday() qui, pour des raisons historiques, renvoie une chaîne de type text plutôt qu'une valeur de type timestamp :

SELECT timeofday();
Résultat : Sat Feb 17
19:07:32.000126 2001 EST

Il est important de savoir que CURRENT_TIMESTAMP et les fonctions relatives renvoient l'heure de début de la transaction courante ; leurs valeurs ne changent pas lors de la transaction. Ceci est considérée comme une fonctionnalité : le but est de permettre à une transaction seule d'avoir une notion consistante de l'heure << courante >>, donc les modifications multiples à l'intérieur de la même transaction partagent la même heure. timeofday() renvoie l'heure de l'horloge et change lors des transactions.

Tous les types de données date/heure acceptent aussi la valeur littérale spéciale now pour spécifier la date et l'heure actuelle. Du coup, les trois suivants renvoient aussi le même résultat :

SELECT CURRENT_TIMESTAMP;
SELECT now();
SELECT TIMESTAMP 'now';