EDate |
Date écoulée |
| Power Fx |
Syntaxe
|
EDate( DateTime, NumberOfMonths )
|
Paramètres
| Nom |
Description |
| DateTime |
Ce paramètre représente la date de référence à partir de laquelle le calcul sera effectué. |
| NumberOfMonths |
Ce paramètre représente le nombre de mois à ajouter ou à soustraire de la date de référence. Si le nombre est positif, il s'agit de mois futurs ; si négatif, de mois passés. |
Description
Cette fonction permet de retourner une date qui est un nombre spécifié de mois avant ou après une date de début.
Remarques
- La fonction EDate est particulièrement utile pour effectuer des calculs de dates mensuelles, comme les échéances ou les délais contractuels. Elle permet
d'ajouter ou de soustraire un nombre entier de mois à une date donnée, ce qui simplifie les opérations fréquentes dans les applications métier. Par exemple, elle est
idéale pour calculer la date d'échéance d'un abonnement ou d'un paiement récurrent.
- Le paramètre NumberOfMonths accepte aussi bien des valeurs positives que négatives. Une valeur positive déplace la date vers le futur, tandis qu'une valeur
négative la recule dans le passé. Cela rend la fonction flexible et applicable aussi bien pour des prévisions que pour des retours sur périodes passées.
- EDate gère automatiquement les ajustements de jours de fin de mois. Par exemple, si la date de départ est le 31 janvier et que vous ajoutez 1 mois, le
résultat sera le 28 ou 29 février, selon l'année. C'est un avantage par rapport à une simple addition manuelle de mois, qui ne tiendrait pas compte de ces cas
particuliers.
- Cette fonction est particulièrement utile dans les calculs périodiques, comme les échéanciers ou les évaluations mensuelles. Elle évite d'avoir à manipuler
manuellement les mois, ce qui peut être source d'erreurs en cas de décalages de jours ou de mois incomplets. C'est une bonne pratique pour gérer des cycles réguliers
basés sur le calendrier.
- EDate prend en paramètre un champ de type DateTime, ce qui permet de travailler aussi bien avec des dates simples que des horodatages. Toutefois, le résultat conserve
uniquement la date, sans ajustement spécifique sur l'heure. Cela signifie qu'elle est plus adaptée aux traitements de date que de date et heure précises.
- En l'intégrant dans une logique Power Fx, EDate peut facilement être combinée avec d'autres fonctions comme Today(), DateDiff,
ou If. Cela permet, par exemple, de générer dynamiquement des échéances ou de vérifier si une date cible est déjà passée. Elle s'intègre donc naturellement
dans des flux de travaux temporels.
- L'utilisation de EDate peut faciliter les analyses de tendances mensuelles, notamment dans des rapports où il est nécessaire de comparer des périodes à
intervalles réguliers. Elle garantit une cohérence dans l'espacement des périodes, indépendamment du nombre de jours par mois. Cela simplifie les calculs dans les
tableaux de bord ou les récapitulatifs temporels.
- La syntaxe de la fonction EDate est simple et directe, ce qui la rend accessible même à ceux qui débutent avec Power Fx. Elle ne nécessite pas de connaître les
subtilités du calendrier pour effectuer des ajustements mensuels précis. Son usage améliore la lisibilité du code et renforce la robustesse des applications liées à
la gestion de temps.
Dernière mise à jour : Jeudi, le 1 Mai 2025