Fonctions de date et d’heure

Dans cette section, vous trouverez des informations sur les fonctions scalaires de date et d’heure prises en charge par Amazon Redshift.

Rubriques

• Résumés des fonctions de date et d’heure
• Fonctions date et heure dans les transactions
• Fonctions de nœud principal uniquement obsolètes
• + Opérateur (concaténation)
• Fonction ADD_MONTHS
• Fonction AT TIME ZONE
• Fonction CONVERT_TIMEZONE
• Fonction CURRENT_DATE
• Fonction DATE_CMP
• Fonction DATE_CMP_TIMESTAMP
• Fonction DATE_CMP_TIMESTAMPTZ
• Fonction DATEADD
• Fonction DATEDIFF
• Fonction DATE_PART
• Fonction DATE_PART_YEAR
• Fonction DATE_TRUNC
• Fonction EXTRACT
• Fonction GETDATE
• Fonction INTERVAL_CMP
• Fonction LAST_DAY
• Fonction MONTHS_BETWEEN
• Fonction NEXT_DAY
• Fonction SYSDATE
• Fonction TIMEOFDAY
• Fonction TIMESTAMP_CMP
• Fonction TIMESTAMP_CMP_DATE
• Fonction TIMESTAMP_CMP_TIMESTAMPTZ
• Fonction TIMESTAMPTZ_CMP
• Fonction TIMESTAMPTZ_CMP_DATE
• Fonction TIMESTAMPTZ_CMP_TIMESTAMP
• Fonction TIMEZONE
• Fonction TO_TIMESTAMP
• Fonction TRUNC
• Parties de date pour les fonctions de date ou d’horodatage

Résumés des fonctions de date et d’heure

Fonction	Syntaxe	Renvoie
+ Opérateur (concaténation) Concatène une date à une heure de chaque côté du symbole + et renvoie une valeur TIMESTAMP ou TIMESTAMPTZ.	date + time	TIMESTAMP ou TIMESTAMPZ
ADD_MONTHS Ajoute le nombre de mois spécifié à un horodatage.	ADD_MONTHS ({date|timestamp}, integer)	TIMESTAMP
AT TIME ZONE Spécifie le fuseau horaire à utiliser avec une expression TIMESTAMP ou TIMESTAMPTZ.	AT TIME ZONE ’timezone’	TIMESTAMP ou TIMESTAMPZ
CONVERT_TIMEZONE Convertit un horodatage d’un fuseau horaire à un autre.	CONVERT_TIMEZONE ([’timezone’,] ’timezone’, timestamp)	TIMESTAMP
CURRENT_DATE Renvoie une date selon le fuseau horaire de la séance en cours (UTC par défaut) pour le début de la transaction en cours.	CURRENT_DATE	DATE
DATE_CMP Compare les deux dates et renvoie 0 si les dates sont identiques, 1 si date1 est ultérieure, et -1 si date2 est ultérieure.	DATE_CMP (date1, date2)	INTEGER
DATE_CMP_TIMESTAMP Compare une date à une heure et renvoie 0 si les valeurs sont identiques, 1 si date est ultérieure et -1 si timestamp est ultérieur.	DATE_CMP_TIMESTAMP (date, timestamp)	INTEGER
DATE_CMP_TIMESTAMPTZ Compare une date et un horodatage avec fuseau horaire et renvoie 0 si les valeurs sont identiques, 1 si date est ultérieure et -1 si timestamptz est ultérieur.	DATE_CMP_TIMESTAMPTZ (date, timestamptz)	INTEGER
DATE_PART_YEAR Extrait l’année d’une date.	DATE_PART_YEAR (date)	INTEGER
DATEADD Incrémente une date ou une heure par un intervalle spécifié.	DATEADD (datepart, interval, {date|time|horaire|timestamp})	TIMESTAMP ou TIME ou TIMETZ
DATEDIFF Renvoie la différence entre deux dates ou heures pour une partie de la date donnée, comme un jour ou un mois.	DATEDIFF (datepart, {date|time|timetz|timestamp}, {date|time|timetz|timestamp})	BIGINT
DATE_PART Extrait une valeur de la partie date d’une date ou d’une heure.	DATE_PART (datepart, {date|timestamp})	DOUBLE
DATE_TRUNC Tronque un horodatage selon une partie de date.	DATE_TRUNC (’datepart’, timestamp)	TIMESTAMP
EXTRACT Extrait une partie de date ou d’heure d’un timestamp, d’un timestamptz, d’un time ou d’un timetz.	EXTRACT (datepart FROM source)	INTEGER or DOUBLE
GETDATE Renvoie la date et l’heure actuelles selon le fuseau horaire en cours (UTC par défaut). Les parenthèses sont obligatoires.	GETDATE()	TIMESTAMP
INTERVAL_CMP Compare deux intervalles et renvoie 0 si les intervalles sont identiques, 1 si interval1 est supérieur, et -1 si interval2 est supérieur.	INTERVAL_CMP (interval1, interval2)	INTEGER
LAST_DAY Renvoie la date du dernier jour du mois qui contient date.	LAST_DAY(date)	DATE
MONTHS_BETWEEN Renvoie le nombre de mois entre deux dates.	MONTHS_BETWEEN (date, date)	FLOAT8
NEXT_DAY Renvoie la date de la première instance de day ultérieure à date.	NEXT_DAY (date, day)	DATE
SYSDATE Renvoie la date et l’heure en UTC pour le début de la transaction en cours.	SYSDATE	TIMESTAMP
TIMEOFDAY Renvoie le jour de la semaine, et la date et l’heure actuelles selon le fuseau horaire en cours (UTC par défaut) sous la forme d’une valeur de chaîne.	TIMEOFDAY()	VARCHAR
TIMESTAMP_CMP Compare deux horodatages et renvoie 0 si les horodatages sont identiques, 1 si timestamp1 est supérieur et -1 si timestamp2 est supérieur.	TIMESTAMP_CMP (timestamp1, timestamp2)	INTEGER
TIMESTAMP_CMP_DATE Compare un horodatage à une date et renvoie 0 si les valeurs sont identiques, 1 si timestamp est ultérieur et -1 si date est ultérieure.	TIMESTAMP_CMP_DATE (timestamp, date)	INTEGER
TIMESTAMP_CMP_TIMESTAMPTZ Compare un horodatage avec un horodatage avec fuseau horaire et renvoie 0 si les valeurs sont égales, 1 si timestamp est supérieur et -1 si timestamptz est supérieur.	TIMESTAMP_CMP_TIMESTAMPTZ (timestamp, timestamptz)	INTEGER
TIMESTAMPTZ_CMP Compare deux valeurs d’horodatage avec fuseau horaire et renvoie 0 si les valeurs sont égales, 1 si timestamptz1 est supérieur et -1 si timestamptz2 est supérieur.	TIMESTAMPTZ_CMP (timestamptz1, timestamptz2)	INTEGER
TIMESTAMPTZ_CMP_DATE Compare la valeur d’un horodatage avec fuseau horaire et une date, puis renvoie 0 si les valeurs sont égales, 1 si timestamptz est supérieur et -1 si date est supérieure.	TIMESTAMPTZ_CMP_DATE (timestamptz, date)	INTEGER
TIMESTAMPTZ_CMP_TIMESTAMP Compare un horodatage avec fuseau horaire avec un horodatage et renvoie 0 si les valeurs sont égales, 1 si timestamptz est supérieur et -1 si timestamp est supérieur.	TIMESTAMPTZ_CMP_TIMESTAMP (timestamptz, timestamp)	INTEGER
TIMEZONE Renvoie un horodatage pour la valeur du fuseau horaire et de l’horodatage spécifiée.	TIMEZONE (’timezone’ { timestamp | timestamptz )	TIMESTAMP ou TIMESTAMPTZ
TO_TIMESTAMP Renvoie un horodatage avec fuseau horaire pour le format de l’horodatage et du fuseau horaire spécifié.	TO_TIMESTAMP (’timestamp’, ’format’)	TIMESTAMPTZ
TRUNC Tronque un horodatage et renvoie une date.	TRUNC(timestamp)	DATE

Note

Les secondes supplémentaires ne sont pas prises en compte dans le calcul de durée écoulée.

Fonctions date et heure dans les transactions

Lorsque vous exécutez les fonctions suivantes au sein d’un bloc de transaction (BEGIN … END), la fonction renvoie la date ou l’heure de début de la transaction en cours, pas le début de l’instruction en cours.

• SYSDATE

• TIMESTAMP

• CURRENT_DATE

Les fonctions suivantes renvoient toujours la date ou l’heure de début de l’instruction en cours, même si elles se trouvaient sur un bloc de transaction.

• GETDATE

• TIMEOFDAY

Fonctions de nœud principal uniquement obsolètes

Les fonctions de date suivantes sont obsolètes, car elles s’exécutent uniquement sur le nœud principal. Pour plus d'informations, consultez Fonctions exécutées uniquement sur le nœud principal.

• AGE. Utilisez Fonction DATEDIFF à la place.

• CURRENT_TIME. Utilisez Fonction GETDATE ou SYSDATE à la place.

• CURRENT_TIMESTAMP. Utilisez Fonction GETDATE ou SYSDATE à la place.

• LOCALTIME. Utilisez Fonction GETDATE ou SYSDATE à la place.

• LOCALTIMESTAMP. Utilisez Fonction GETDATE ou SYSDATE à la place.

• ISFINITE

• NOW. Utilisez Fonction GETDATE ou SYSDATE à la place.