date_add_years

Syntaxe

Paramètres

Description

Ce filtre permet d'ajouter un nombre d'années à une date.

Remarques

• Pratique pour manipuler des échéances ou anniversaires : Le filtre date_add_years est particulièrement utile lorsqu'on doit calculer des échéances régulières, comme les renouvellements annuels, les anniversaires ou la durée de validité d'un document sur plusieurs années. Il permet d'automatiser ce type de logique temporelle sans opération complexe.
• Gère correctement les années bissextiles : Ce filtre prend en compte les particularités du calendrier, notamment les années bissextiles. Par exemple, si l'on ajoute un an à une date comme le 29 février 2020, le résultat sera correctement ajusté (souvent 28 février ou 1er mars selon les règles internes du moteur Liquid).
• Autorise l'ajout ou la soustraction d'années : En acceptant des valeurs négatives, date_add_years permet aussi bien d'avancer dans le futur que de reculer dans le passé. Cela est utile pour évaluer une date d'origine, afficher une date d'expiration passée ou calculer une différence d'ancienneté.
• Utile pour les portails affichant des cycles longs : Sur les portails Power Pages affichant des informations à long terme, comme l'historique d'un client, les prévisions fiscales ou les abonnements multi-années, ce filtre permet de faire varier dynamiquement une date sur plusieurs années.
• Peut être combiné avec d'autres filtres temporels : Il est possible d'utiliser date_add_years avec d'autres filtres comme date_add_months ou date_add_days pour construire des délais complexes. Par exemple, ajouter 1 an et 6 mois à une date de départ pour représenter une période contractuelle.
• Idéal pour créer des échéanciers dans des boucles : Dans une boucle for, ce filtre permet de générer un échéancier annuel dynamique. Par exemple, on peut afficher les années de renouvellement successives à partir d'une date de début grâce à l'incrémentation de l'année à chaque itération.
• Aide à la validation de champs ou au calcul d'âges : En comparant une date modifiée avec la date actuelle, on peut déterminer si un utilisateur est majeur ou si un événement date de plus de 5 ans. Le filtre facilite donc la logique conditionnelle dans les formulaires ou listes.
• Simple à utiliser pour les utilisateurs non développeurs : Grâce à sa syntaxe lisible et à l'absence de logique conditionnelle complexe, ce filtre est facilement utilisable par des administrateurs fonctionnels ou créateurs de contenu sans avoir besoin de programmation poussée. Il renforce l'accessibilité des fonctionnalités Liquid.