Fonctions de date et d’heure - Amazon Redshift

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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.

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.