date_add_hours |
Date : Ajout des heures |
|---|---|
| Liquid (Microsoft) | |
Syntaxe
| {{ date_variable | date_add_hours: nombre_d_heures }} |
Paramètres
| Nom | Description |
|---|---|
| date_variable | Ce paramètre permet d'indiquer la date de départ à laquelle les heures seront ajoutées. |
| nombre_d_heures | Ce paramètre permet de spécifier le nombre d'heures à ajouter à la date. La valeur peut être positive (pour avancer l'heure) ou négative (pour la reculer). |
Description
Ce filtre permet d'ajouter un nombre d'heures à une date.
Remarques
- Utile pour les calculs horaires précis dans les portails : Le filtre date_add_hours permet de manipuler des heures avec précision, ce qui est particulièrement utile pour gérer des délais, des créneaux horaires ou des horaires d'ouverture dans les portails Power Pages.
- Accepte des valeurs négatives ou positives pour ajuster dans le temps : Le paramètre peut être positif pour avancer l'heure, ou négatif pour la reculer. Cela rend ce filtre très souple, que l'on cherche à projeter une échéance dans le futur ou à revenir à une heure passée.
- Compatible avec des valeurs dynamiques de type variable ou champ de formulaire : Le nombre d'heures à ajouter (nombre_d_heures) peut provenir d'une variable Liquid ou d'un champ de saisie utilisateur, permettant de créer des horaires ajustés en fonction des préférences ou des rôles.
- Pratique pour les logiques de temporisation, réservation ou alertes : Ce filtre s'intègre parfaitement dans les scénarios où une heure d'expiration, de disponibilité ou de déclenchement est nécessaire, comme dans les systèmes de réservation, de notifications ou de délais dynamiques.
- Peut être enchaîné avec date pour formater la sortie : Pour afficher le résultat dans un format lisible, on peut chaîner date_add_hours avec date, par exemple :
- {{ "now" | date_add_hours: 5 | date: "HH:mm" }}
- Fonctionne avec des dates calculées ou littérales : Le filtre peut s'appliquer aussi bien à une variable contenant une date qu'à une chaîne de type "2025-07-25 10:00". Cela facilite son utilisation sans conversions préalables complexes.
- Indispensable pour gérer des fuseaux horaires localisés manuellement : En ajoutant ou retirant un certain nombre d'heures, on peut simuler un décalage horaire, par exemple entre UTC et l'heure locale d'un utilisateur, ce qui est très utile pour adapter les affichages temporels.
- N'altère pas la valeur d'origine de la date : Le filtre retourne une nouvelle valeur transformée sans modifier la date initiale. Cela permet de conserver la trace du point de départ tout en générant des variantes temporelles pour d'autres usages dans la même page.
Cela permet d'obtenir une heure précise, adaptée à l'affichage.
Dernière mise à jour : Jeudi, le 24 Juillet 2025