DateAdd

Syntaxe

Paramètres

Description

Cette fonction permet d'ajouter une durée spécifiée à une date.

Remarques

• La fonction DateAdd est utile pour modifier dynamiquement des dates dans une application Power Fx. Elle permet d'ajouter une durée (jours, mois, années,...) à une date donnée, ce qui est essentiel pour calculer des échéances, des rappels ou des délais. C'est une fonction couramment utilisée dans les scénarios de planification.
• Le paramètre DateTime constitue le point de départ de l'opération. Il peut s'agir d'une date fixe, d'un champ issu d'une base de données ou d'une date obtenue dynamiquement (comme Now() ou Today()). Ce paramètre donne toute la souplesse nécessaire pour adapter les calculs de date à divers contextes.
• Le paramètre Addition accepte un nombre, positif ou négatif, ce qui permet à la fonction DateAdd d'ajouter ou de soustraire du temps. Par exemple, DateAdd(Today(), -7, Days) permet de reculer d'une semaine. Cela rend la fonction bidirectionnelle et donc adaptée aussi bien aux projections futures qu'aux analyses rétroactives.
• Le paramètre Units est optionnel, mais il détermine la granularité du temps ajouté. On peut spécifier des unités comme "Days", "Months" ou "Years", selon les besoins. Cette précision permet d'adapter les calculs à des contextes variés, comme des échéanciers mensuels ou des extensions de contrats annuelles.
• Si le paramètre Units est omis, Power Fx considère par défaut l'unité comme "Days". Cela évite les erreurs dans les cas simples et améliore la lisibilité des formules les plus courantes. Cependant, il est recommandé de toujours préciser l'unité pour éviter les ambiguïtés, surtout dans des projets complexes.
• La fonction DateAdd est précieuse lorsqu'on travaille avec des flux de travaux dépendants du temps, comme les délais de traitement, les délais de livraison ou les rappels automatiques. Elle facilite l'automatisation des calculs de dates, réduisant ainsi le risque d'erreur humaine. Elle peut également être utilisée dans les filtres et les conditions logiques.
• Associée à des contrôles d'interface comme DatePicker ou Dropdown, DateAdd permet de générer automatiquement des dates futures ou passées en fonction des choix de l'utilisateur. Cela renforce l'interactivité de l'application et permet de construire des formulaires intelligents ou des tableaux de bord dynamiques. C'est un outil indispensable pour les scénarios orientés utilisateur.
• Enfin, DateAdd gère correctement les dépassements de mois ou d'année. Par exemple, DateAdd(Date(2023, 1, 31), 1, Months) retournera automatiquement le 28 février 2023 (ou 29 en année bissextile). Ce comportement natif garantit une bonne fiabilité dans les calculs, même avec des cas particuliers du calendrier.