DATETIME_ADD

Exemple d'utilisation

DATETIME_ADD(Order Date, INTERVAL 1 WEEK)

Syntaxe

DATETIME_ADD( datetime_expression, INTERVAL integer part )

Paramètres

  • datetime_expression : expression ou champ de type "Date" ou "Date et heure".
  • integer : champ ou expression numérique représentant le nombre de parties à 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 dont le jeudi appartient à l'année civile grégorienne correspondante.

Type de données renvoyées

Date et heure

Examples

Example formula Output
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.