DATETIME_ADD

Ajoute un intervalle de temps spécifié à une date ou à une date et heure.

Exemple d'utilisation

DATETIME_ADD(Order Date, INTERVAL 1 WEEK)

Syntaxe

DATETIME_ADD( datetime_expression, INTERVAL integer part )

Paramètres

  • datetime_expression : un champ ou une expression de type "Date" ou "Date et heure".
  • integer : un champ ou une expression numériques représentant le nombre d'éléments à ajouter.
  • part : unité de mesure du temps à ajouter. DATETIME_ADD accepte les valeurs suivantes pour part :
    • MICROSECOND : disponible pour les champs ou les expressions de type "Date et heure".
    • MILLISECOND : disponible pour les champs ou les expressions de type "Date et heure".
    • SECOND : disponible pour les champs ou les expressions de type "Date et heure".
    • MINUTE : disponible pour les champs ou les expressions de type "Date et heure".
    • HOUR : disponible pour les champs ou les expressions de type "Date et heure".
    • DAY
    • WEEK : cette partie de date commence le dimanche.
    • ISOWEEK : utilise les limites de semaine ISO 8601. Les semaines ISO commencent le lundi.
    • MONTH
    • QUARTER
    • YEAR
    • ISOYEAR : utilise la limite d'année à numérotation de semaines ISO 8601. La limite d'année ISO est le lundi de la première semaine où le jeudi appartient à l'année civile grégorienne correspondante.

Type de données renvoyé

Date et heure

Exemples

Exemple de formule Sortie
DATETIME_ADD(DATETIME "2023-01-25 15:30:00", INTERVAL 10 MINUTE)

25 janvier 2023, 15:40

DATETIME_ADD(DATE "2023-01-25", INTERVAL 5 DAY)

30 janvier 2023, 00:00

Remarques

Cette fonction n'est pas disponible pour les types de dates en mode de compatibilité.

Lorsque vous utilisez des éléments MONTH, QUARTER ou YEAR, si la date obtenue correspond au dernier jour du mois (ou à un jour très proche), DATETIME_ADD renvoie le dernier jour du mois. Cela peut se produire lorsque le mois de la date obtenue comporte moins de jours que le mois de la date de début.

Par exemple, si Date = 31 août 2020, DATETIME_ADD(Date, INTERVAL 1 MONTH) renvoie le 30 septembre 2020.