date_add_days |
Date : Ajout des jours |
| Liquid (Microsoft) |
Syntaxe
|
{{ date_variable | date_add_days: n }}
|
Paramètres
| Nom |
Description |
| date_variable |
Ce paramètre permet d'indiquer la date de départ à laquelle les jours seront ajoutés. |
| n |
Ce paramètre permet de spécifier le nombre de jours à ajouter à la date. La valeur peut être positive (pour une date future) ou négative (pour une date passée). |
Description
Ce filtre permet d'ajouter un nombre de jours à une date.
Remarques
- Permet de manipuler dynamiquement des dates dans Liquid : Le filtre date_add_days est particulièrement utile pour effectuer des calculs de dates
directement dans le code Liquid, sans avoir à recourir à des fonctions JavaScript ou côté serveur. Il rend les
opérations temporelles plus accessibles dans les portails.
- Accepte des valeurs positives et négatives pour la flexibilité : On peut aussi bien ajouter que soustraire des jours grâce à une valeur négative. Cela
permet de générer facilement des échéances futures, des dates d'expiration, ou de remonter dans le passé pour afficher des éléments historiques.
- Peut être utilisé pour calculer des plages de dates : En combinant plusieurs utilisations du filtre (exemple : start_date, start_date | date_add_days: 7), il
devient simple de générer des intervalles temporelles comme "du 1er au 7 juillet", sans écrire de logique conditionnelle complexe.
- Prend en charge des variables dynamiques comme sources : Le paramètre n peut lui-même être une variable Liquid. Cela permet d'ajuster dynamiquement
le nombre de jours selon le contexte utilisateur, des paramètres d'URL, ou des valeurs récupérées dans Dataverse.
- Utile dans les scénarios d'automatisation ou de logique métier : Ce filtre permet de mettre en place des règles comme "afficher tous les éléments créés
dans les 30 derniers jours" ou "ajouter 15 jours à la date d'aujourd'hui pour la date d'échéance" directement dans l'interface Liquid d'un portail
Power Pages.
- Ne modifie pas la date d'origine, ce qui évite les effets de bord : La date d'origine reste inchangée : le filtre retourne une nouvelle date résultant de
l'ajout. Cela permet de manipuler et comparer plusieurs versions de la même date sans perdre l'information initiale.
- Combine bien avec le filtre date pour un affichage personnalisé : Après avoir utilisé date_add_days, on peut enchaîner avec le filtre date pour formater
la nouvelle date selon un modèle lisible, par exemple :
- {{ myDate | date_add_days: 3 | date: "MMMM d, yyyy" }}.
- Fonctionne également avec la date actuelle si elle est fournie via now : En utilisant now comme point de départ ({{ "now" | date_add_days: 7 }}),
on peut générer des dates relatives à aujourd'hui. Cela est utile pour afficher des dates de rappel, de renouvellement ou d'invalidité automatique.
Dernière mise à jour : Jeudi, le 24 Juillet 2025