date_add_months |
Date : Ajout des mois |
| Liquid (Microsoft) |
Syntaxe
|
{{ date_variable | date_add_months: nombre_de_mois }}
|
Paramètres
| Nom |
Description |
| date_variable |
Ce paramètre permet d'indiquer la date d'origine à laquelle les mois seront ajoutés. |
| nombre_de_mois |
Ce paramètre permet de spécifier le nombre de mois à ajouter à la date. Il peut être positif pour avancer la date ou négatif pour la reculer. |
Description
Ce filtre permet d'ajouter un nombre de mois à une date.
Remarques
- Gère les transitions de mois avec changement d'année : Le filtre date_add_months est capable d'ajouter un nombre de mois qui dépasse 12, et ajuste
automatiquement l'année. Par exemple, ajouter 14 mois à janvier 2023 donnera mars 2024. Cela simplifie grandement les calculs à long terme.
- Tient compte des irrégularités de calendrier : Lorsqu'on ajoute un nombre de mois à une date comme le 31 janvier, il gère intelligemment les mois plus
courts. Par exemple, 31 janvier + 1 mois devient 28 février ou 29 février selon les années, évitant ainsi des erreurs de date invalides.
- Permet des calculs temporels à moyen ou long terme : Ce filtre est très utile pour créer des échéances comme des dates de renouvellement d'abonnement,
des échéanciers de paiements mensuels ou des échéances contractuelles à plusieurs mois.
- Accepte des valeurs négatives pour reculer dans le temps : En spécifiant une valeur négative, on peut facilement remonter dans le passé. Cela permet
par exemple de retrouver la date d'un événement antérieur ou d'établir une plage de validité en mois.
- Compatible avec des formats de date variés : Le paramètre date_variable peut être une date au format ISO 8601 ou une variable contenant une
vraie date, ce qui permet une grande souplesse dans les sources de données (formulaire, base, URL...).
- Souvent combiné avec date pour affichage lisible : Comme la sortie est une nouvelle date brute, il est fréquent d'enchaîner ce filtre avec date pour
un affichage formaté, par exemple :
- {{ date_debut | date_add_months: 6 | date: "dd/MM/yyyy" }}.
- Indispensable dans les portails de gestion de durée ou échéance : Sur Power Pages ou dans Dynamics, ce filtre s'avère crucial pour
tout scénario impliquant des échéances mensuelles : extensions de contrats, dates limites, suivi d'entretien périodique,...
- Respecte la logique du calendrier grégorien : Ce filtre applique automatiquement les règles de gestion de mois telles que les mois de 28, 30 ou
31 jours, évitant ainsi d'avoir à coder manuellement ces règles. Cela rend son usage fiable pour la majorité des cas professionnels.
Dernière mise à jour : Jeudi, le 24 Juillet 2025
