date

Syntaxe

Paramètres

Description

Ce filtre permet de formater une date selon un modèle spécifié.

Remarques

• Permet un affichage personnalisé des dates : Le filtre date est essentiel pour afficher une date dans un format lisible ou adapté à un contexte particulier. Il transforme un objet de type date (ou une chaîne de date valide) en un texte formaté selon un modèle défini par le développeur.
• Compatible avec une grande variété de formats : Le paramètre "format" peut utiliser des combinaisons de lettres pour représenter le jour, le mois, l'année, l'heure,... Par exemple, "dd/MM/yyyy" produit un affichage européen classique, tandis que "MMMM d, yyyy" donne une version textuelle plus longue.
• Utile pour les interfaces multilingues : En fonction de la configuration régionale du portail, le filtre peut restituer le nom des mois ou des jours dans la langue de l'utilisateur. Cela facilite la localisation des interfaces sans logique conditionnelle supplémentaire.
• Peut être appliqué à des dates dynamiques ou statiques : Le filtre accepte aussi bien une variable contenant une date qu'une chaîne fixe. Cela permet de formater aussi bien une date issue d'une base de données qu'un horodatage défini manuellement dans le code Liquid.
• Doit être utilisé avec précaution sur des chaînes mal formées : Si la valeur transmise n'est pas une date valide, le filtre peut échouer silencieusement ou retourner une chaîne vide. Il est donc préférable de s'assurer que la donnée est bien typée avant d'appliquer le filtre.
• Ne modifie pas la valeur de la date d'origine : Le filtre date n'altère pas la donnée d'origine, il ne fait qu'en retourner une version formatée. Cela permet de réutiliser la même variable plus loin dans le code, dans un autre format si nécessaire.
• Prend en charge l'affichage de l'heure en complément de la date : En utilisant des codes comme "HH:mm" ou "h:mm tt", il est possible d'inclure des informations horaires dans le rendu. Cela est utile pour des portails affichant des événements, des réservations ou des activités programmées.
• Peut servir dans les conditions ou pour le tri si combiné avec d'autres filtres : Bien qu'il soit principalement destiné à l'affichage, date peut être combiné avec des filtres comme sort ou where lorsqu'on travaille avec des collections d'objets contenant des dates. Cela permet d'organiser dynamiquement les éléments.