ceil

Syntaxe

Paramètres

Description

Ce filtre permet d'arrondir un nombre à l'entier supérieur.

Remarques

• Effectue un arrondi vers le haut, même pour les valeurs proches de l'entier : Le filtre ceil arrondit toujours vers l'entier supérieur, quel que soit le chiffre après la virgule. Par exemple, 3.01 deviendra 4, tout comme 3.99. Ce comportement est systématique, contrairement à l'arrondi standard qui dépend du chiffre après la virgule.
• Idéal pour calculer des totaux ou seuils minimaux : Dans des cas où un résultat partiel ne suffit pas (exemple : nombre de pages, nombre de lots requis), ceil est particulièrement utile pour s'assurer que la valeur atteigne ou dépasse un seuil complet sans jamais tomber en dessous.
• Conserve la logique mathématique de l'arrondi supérieur (plafond) : Ce filtre suit la même logique que la fonction mathématique "plafond" (ou Math.ceil() en JavaScript). Il est donc cohérent avec d'autres environnements de développement, ce qui facilite la portabilité des logiques de traitement numérique.
• Ne modifie pas les valeurs déjà entières : Lorsqu'on applique ceil à un nombre entier comme 5, le résultat reste 5. Cela garantit que les données déjà en forme correcte ne seront pas altérées, ce qui est utile dans des traitements mixtes.
• Peut être combiné avec des opérations mathématiques avant l'arrondi : Ce filtre est souvent utilisé après une division, une moyenne ou une multiplication. Par exemple : {{ total_items | divided_by: 4 | ceil }} permet de déterminer combien de groupes de 4 sont nécessaires, sans en omettre un.
• Donne toujours un résultat numérique entier (pas de chaîne de caractères) : Le résultat de ceil est un entier pur, ce qui signifie qu'il peut ensuite être utilisé directement dans d'autres opérations numériques sans nécessiter de conversion explicite.
• Utile pour des interfaces avec contraintes d'affichage : Lorsque l'on souhaite afficher un nombre fixe de blocs, de lignes ou de pages, ceil évite de tronquer accidentellement des éléments à cause de la décimale. Cela améliore la robustesse des calculs dans l'interface utilisateur.
• Comportement déterministe : aucune ambiguïté selon la langue ou culture : Contrairement à d'autres fonctions numériques pouvant dépendre du séparateur décimal (virgule ou point), ceil agit toujours de la même manière, indépendamment du paramétrage régional ou linguistique du portail.