date_to_iso8601 |
Date vers ISO 8601 |
| Liquid (Microsoft) |
Syntaxe
|
{{ date_variable | date_to_iso8601 }}
|
Paramètres
| Nom |
Description |
| date_variable |
Ce paramètre permet d'indiquer la date à convertir au format ISO 8601, un standard international pour la représentation des dates et heures. |
Description
Ce filtre permet de convertir une date au format ISO 8601.
Remarques
- Assure l'uniformité des formats de date dans les échanges de données : Le format ISO 8601 est un standard reconnu internationalement (exemple :
2025-07-25T14:30:00Z). En convertissant une date locale en ce format, date_to_iso8601 garantit que les systèmes externes ou les API reçoivent une date lisible et non
ambiguë.
- Indispensable pour l'intégration avec des systèmes tiers : Lorsqu'un portail Power Pages interagit avec des services comme
Azure Functions, des webhooks ou d'autres applications via HTTP,
il est crucial que les dates soient envoyées dans un format standardisé. Ce filtre évite les erreurs d'analyse côté réception.
- Utile dans les contextes multilingues et multi-fuseaux horaires : En utilisant date_to_iso8601, on supprime toute ambigüité liée au format régional des
dates (exemple : 07/08/2025 pourrait signifier 7 août ou 8 juillet). Cela améliore la fiabilité des applications internationales ou accessibles depuis plusieurs
pays.
- Facilite le tri et le filtrage des dates dans les bases de données : Les dates ISO 8601 sont organisées dans un ordre logique : année, mois, jour,...
Cela permet un tri naturel des chaînes de caractères représentant des dates sans transformation supplémentaire, ce qui est utile lors du rendu d'entités dans une page
Liquid.
- Simplifie les comparaisons de dates dans les scripts personnalisés : Une fois converties en ISO 8601, les dates peuvent être comparées lexicalement comme
de simples chaînes. Cela simplifie grandement la logique conditionnelle dans les gabarits, surtout si l'on ne veut pas manipuler directement des objets datetime.
- Peut être utilisé avec d'autres filtres pour générer des données JSON : Ce filtre est particulièrement utile lorsqu'on prépare une réponse
JSON à partir d'un modèle Liquid. Le champ date sera bien formaté pour les consommateurs
JavaScript ou autres clients REST, ce qui évite les conversions côté client.
- Évite les erreurs d'affichage dans les formats personnalisés : Au lieu de construire un format de date manuellement avec le filtre date, il est parfois
plus sûr d'utiliser date_to_iso8601, qui encapsule les bonnes pratiques et le bon ordre des composants temporels (y compris les secondes et le fuseau horaire).
- Permet de suivre les bonnes pratiques en développement logiciel : De nombreuses normes recommandent de toujours stocker ou transmettre les dates en ISO 8601,
quel que soit le langage ou la plateforme utilisée. Utiliser ce filtre dans les gabarits Liquid respecte donc les standards d'interopérabilité et de maintenabilité.
Dernière mise à jour : Jeudi, le 24 Juillet 2025