date_add_seconds |
Date : Ajout de secondes |
| Liquid (Microsoft) |
Syntaxe
|
{{ date_variable | date_add_seconds: nombre_de_secondes }}
|
Paramètres
| Nom |
Description |
| date_variable |
Ce paramètre permet d'indiquer la date de départ à laquelle les secondes seront ajoutées. |
| nombre_de_secondes |
Ce paramètre permet de spécifier le nombre de secondes à ajouter à la date. Il peut être positif ou négatif selon le sens de l'ajustement souhaité. |
Description
Ce filtre permet d'ajouter un nombre de secondes à une date.
Remarques
- Permet des ajustements temporels très précis : Le filtre date_add_seconds est idéal pour les scénarios nécessitant une grande précision temporelle,
comme les systèmes de journalisation ou les minuteries. En ajoutant ou en soustrayant des secondes, on peut gérer des intervalles très courts de manière fiable.
- Utile pour les calculs d'expiration ou de délais courts : Il peut être utilisé pour calculer une date de fin à partir d'un délai en secondes. Par exemple,
un lien temporaire ou un code de validation actif pendant 120 secondes peut être géré avec ce filtre pour définir une limite exacte.
- Accepte des valeurs négatives pour revenir dans le passé : Le paramètre nombre_de_secondes peut être négatif, ce qui permet de reculer dans le temps. Cela
est utile dans les cas où il faut déterminer un moment précédent, comme "il y a exactement 30 secondes".
- Fonctionne avec n'importe quelle valeur de date valide : Le filtre est compatible avec des objets date, des chaînes de caractères représentant des dates,
ou des variables contenant des horodatages, ce qui le rend polyvalent et adaptable à plusieurs sources de données.
- Peut être combiné avec le filtre date pour formatage : Une fois les secondes ajoutées, la nouvelle valeur peut être affichée de manière lisible à
l'aide du filtre date. Par exemple : {{ date_actuelle | date_add_seconds: 90 | date: "HH:mm:ss" }} permet d'afficher l'heure exacte 90 secondes plus tard.
- Particulièrement utile dans des boucles ou des listes temporelles : Dans des scénarios où l'on génère plusieurs horodatages espacés de quelques
secondes (logs, requêtes, notifications planifiées), ce filtre facilite la création dynamique de ces instants avec un décalage précis.
- Respecte les transitions de minutes et d'heures automatiquement : Lorsqu'on ajoute un nombre important de secondes, le filtre gère automatiquement
les transitions vers les minutes, heures, voire jours suivants sans erreur. Par exemple, 3661 secondes deviennent 1 heure, 1 minute et 1 seconde.
- Précieux dans les environnements interactifs ou en temps réel : Pour les portails nécessitant une réactivité temporelle, comme les formulaires
limités dans le temps ou les compteurs dynamiques, date_add_seconds offre une base fiable pour évaluer ou comparer des horodatages précis.
Dernière mise à jour : Jeudi, le 24 Juillet 2025