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.
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 |
DATE_CMP (date1, date2) | INTEGER |
DATE_CMP_TIMESTAMP Compare une date à une heure et renvoie |
DATE_CMP_TIMESTAMP (date, timestamp) | INTEGER |
DATE_CMP_TIMESTAMPTZ Compare une date et un horodatage avec fuseau horaire et renvoie |
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 |
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 |
TIMESTAMP_CMP (timestamp1, timestamp2) | INTEGER |
TIMESTAMP_CMP_DATE Compare un horodatage à une date et renvoie |
TIMESTAMP_CMP_DATE (timestamp, date) | INTEGER |
TIMESTAMP_CMP_TIMESTAMPTZ Compare un horodatage avec un horodatage avec fuseau horaire et renvoie |
TIMESTAMP_CMP_TIMESTAMPTZ (timestamp, timestamptz) | INTEGER |
TIMESTAMPTZ_CMP Compare deux valeurs d’horodatage avec fuseau horaire et renvoie |
TIMESTAMPTZ_CMP (timestamptz1, timestamptz2) | INTEGER |
TIMESTAMPTZ_CMP_DATE Compare la valeur d’un horodatage avec fuseau horaire et une date, puis renvoie |
TIMESTAMPTZ_CMP_DATE (timestamptz, date) | INTEGER |
TIMESTAMPTZ_CMP_TIMESTAMP Compare un horodatage avec fuseau horaire avec un horodatage et renvoie |
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.