round

Syntaxe

Paramètres

Description

Ce filtre permet d'arrondir un nombre à l'entier le plus proche (avec option de précision).

Remarques

• Arrondit à l'entier le plus proche par défaut : Le filtre round effectue un arrondi standard, c'est-à-dire qu'il arrondit vers l'entier le plus proche. Par exemple, 2.4 devient 2, et 2.6 devient 3. Cela le rend très utile lorsqu'on souhaite simplifier des nombres à des fins d'affichage.
• Accepte les nombres positifs ou négatifs : Ce filtre fonctionne aussi bien avec des valeurs positives que négatives. Par exemple, -2.5 sera arrondi à -2, et -2.6 à -3. Il respecte donc la logique de l'arrondi mathématique traditionnel, même pour des valeurs en dessous de zéro.
• Peut prendre un second argument pour la précision : Bien que souvent utilisé sans paramètre supplémentaire, round peut accepter un deuxième paramètre pour spécifier le nombre de décimales. Par exemple, {{ 3.14159 | round: 2 }} renverra 3.14. Cela le rend flexible dans les cas où un arrondi partiel est souhaité.
• Utile pour formater les prix ou montants : L'arrondi est indispensable pour formater des valeurs monétaires, notamment en réduisant un calcul complexe à deux décimales pour l'affichage. Ainsi, une opération telle que {{ montant_total | round: 2 }} permet de présenter des valeurs fiables à l'utilisateur.
• Fonctionne aussi avec des variables numériques : Il n'est pas limité aux valeurs codées en dur : round peut être utilisé sur des variables, ce qui est essentiel dans des scénarios dynamiques où les données sont issues de bases de données, d'entrées utilisateurs ou d'APIs.
• Évite les affichages déroutants pour l'utilisateur final : Un nombre avec de nombreuses décimales peut sembler imprécis ou inutilement complexe pour un visiteur. round permet de nettoyer visuellement une donnée chiffrée tout en préservant sa signification principale.
• Doit être utilisé avec précaution dans les calculs précis : Pour les applications où la précision est cruciale (exemple : calculs financiers ou scientifiques), round peut provoquer une perte d'information. Il convient donc de ne l'utiliser que pour l'affichage ou lorsque la précision n'est pas un enjeu majeur.
• Complémentaire d'autres filtres comme plus, times,... : Souvent, le filtre round est combiné à d'autres opérations mathématiques comme plus, minus, times ou divided_by, afin de présenter un résultat final propre. Par exemple : {{ prix * taxe | round: 2 }} assure que le montant affiché respecte le format monétaire attendu.