Parties de date pour les fonctions de date ou d'horodatage

Le tableau suivant identifie les noms de partie de date et d’horodatage et les abréviations qui sont acceptées comme arguments pour les fonctions suivantes :

• DATEADD

• DATEDIFF

• DATE_PART

• EXTRACT

Partie de date ou de temps	Abréviations
millénaire, millénaires	mil
siècle, siècles	s, siècle, siècles
décennie, décennies	déc
époque	époque (prise en charge par la EXTRACT)
année, années	an, ans
trimestre, trimestres	trim
mois	mois
semaine, semaines	s, sem
jour de la semaine	jdls (pris en charge par les fonctions DATE_PART et Fonction EXTRACT) Renvoie un nombre entier compris entre 0 et 6, en commençant par le dimanche. Note La partie de date DOW se comporte différemment de la partie de date jour de la semaine (D) utilisée pour les chaînes au format datetime. D s’appuie sur des nombres entiers compris entre 1 et 7, où le dimanche est 1. Pour plus d'informations, consultez Chaînes de format datetime.
jour de l’année	dayofyear, doy, dy, yearday (prise en charge par la EXTRACT)
jour, jours	d
heure, heures	h
minute, minutes	m, min
seconde, secondes	s
milliseconde, millisecondes	ms
microseconde, microsecondes	µs
timezone, timezone_hour, timezone_minute	Pris en charge par la EXTRACT pour l’horodatage avec fuseau horaire (TIMESTAMPTZ) uniquement.

Variations de résultats avec les secondes, les millisecondes et les microsecondes

Des différences mineures dans les résultats de la requête se produisent lorsque d’autres fonctions de date spécifient les secondes, les millisecondes ou les microsecondes comme des parties de date :

• La fonction EXTRACT renvoie des nombres entiers pour la partie de date spécifiée uniquement, sans tenir compte des parties de date de niveau supérieur et inférieur. Si la partie de date spécifiée est les secondes, les millisecondes et les microsecondes ne figurent pas dans le résultat. Si la partie de date spécifiée est les millisecondes, les secondes et les microsecondes ne sont pas incluses. Si la partie de date spécifiée est les microsecondes, les secondes et les millisecondes ne sont pas incluses.

• La fonction DATE_PART renvoie la seconde partie complète de l’horodatage, quelle que soit la partie de date spécifiée, en renvoyant une valeur décimale ou un nombre entier comme requis.

Remarques sur CENTURY, EPOCH, DECADE et MIL

CENTURY ou CENTURIES

AWS Clean Rooms interprète un CENTURY comme commençant par l'année ## #1 et se terminant par l'année : ###0

select extract (century from timestamp '2000-12-16 12:21:13');
date_part
-----------
20
(1 row)

select extract (century from timestamp '2001-12-16 12:21:13');
date_part
-----------
21
(1 row)

EPOCH

L' AWS Clean Rooms implémentation d'EPOCH est relative au 1970-01-01 00:00:00.000 quel que soit le fuseau horaire dans lequel réside le cluster. Vous devrez peut-être décaler les résultats de la différence en heures selon le fuseau horaire sur lequel se trouve le cluster.

DECADE ou DECADES

AWS Clean Rooms interprète le DECADE ou DECADES DATEPART en fonction du calendrier commun. Par exemple, si le calendrier commun commence à partir de l’année 1, la première décennie (décennie 1) est 0001-01-01 jusqu’au 0009-12-31, et la deuxième décennie (décennie 2) du 0010-01-01 au 0019-12-31. Par exemple, la décennie 201 s’étend du 2000-01-01 au 2009-12-31 :

select extract(decade from timestamp '1999-02-16 20:38:40');
date_part
-----------
200
(1 row)

select extract(decade from timestamp '2000-02-16 20:38:40');
date_part
-----------
201
(1 row)

select extract(decade from timestamp '2010-02-16 20:38:40');
date_part
-----------
202
(1 row)

MIL ou MILS

AWS Clean Rooms interprète un MIL comme commençant par le premier jour de l'année #001 et se terminant par le dernier jour de l'année #000 :

select extract (mil from timestamp '2000-12-16 12:21:13');
date_part
-----------
2
(1 row)

select extract (mil from timestamp '2001-12-16 12:21:13');
date_part
-----------
3
(1 row)