date_add_minutes

Syntaxe

Paramètres

Description

Ce filtre permet d'ajouter un nombre de minutes à une date.

Remarques

• Permet un contrôle temporel très granulaire : Contrairement aux filtres d'ajout de jours ou d'heures, date_add_minutes autorise des ajustements fins à la minute près. C'est indispensable pour les systèmes nécessitant une précision élevée, comme des minuteries ou des créneaux très courts.
• Utile pour le calcul de délais ou durées personnalisées : Ce filtre est idéal pour générer des échéances précises, comme «maintenant + 15 minutes», par exemple pour fixer l'expiration d'un lien, d'un code ou d'une session temporaire.
• Peut être utilisé avec des valeurs dynamiques : La valeur nombre_de_minutes peut provenir d'un champ de formulaire, d'un paramètre d'URL, ou d'une autre variable Liquid, ce qui permet de créer des délais adaptatifs selon le contexte ou le profil utilisateur.
• Accepte des valeurs négatives pour reculer dans le temps : Le paramètre peut être négatif, ce qui est pratique pour retracer des événements passés ou vérifier si une date est dépassée par comparaison avec une version « -X minutes ».
• Peut être combiné avec le filtre date pour affichage formaté : Comme le résultat retourne un objet de type date, il est souvent utilisé en chaîne avec date pour afficher un résultat formaté, par exemple :
1. {{ "now" | date_add_minutes: 30 | date: "HH:mm" }}.


• Compatible avec des variables de type texte ou date : La source date_variable peut être une vraie date ou une chaîne ISO 8601. Cela facilite l'intégration dans des systèmes où les dates sont parfois entreposées sous forme de texte.
• Ne modifie pas la valeur d'origine : Comme la plupart des filtres Liquid, date_add_minutes est non destructif : il retourne une nouvelle date modifiée, sans altérer la variable de base. On peut ainsi créer des variantes sans perdre l'information initiale.
• Particulièrement utile dans des portails avec logique de rendez-vous ou minuteries : Dans Power Pages, ce filtre est très pratique pour les scénarios liés aux réservations, à la prise de rendez-vous, ou à la gestion d'actions dépendantes du temps, comme un message d'alerte à afficher juste avant l'expiration d'une offre.