DATETIME_ADD

Ajoute un intervalle de temps spécifié à une date ou à une date et une 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érique représentant le nombre d'éléments à ajouter.
  • part : l'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 des données renvoyées

Date et heure

Exemples

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

25 janv. 2023 15:40:00

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

30 janv. 2023 00: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 30 septembre 2020.