floor

Syntaxe

Paramètres

Description

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

Remarques

• Arrondi systématique vers le bas, sans exception : Le filtre floor effectue un arrondi à l'entier inférieur le plus proche, indépendamment de la fraction décimale. Par exemple, 5.9 devient 5, et -2.1 devient -3, car le plancher descend toujours, même pour les nombres négatifs. Cela le distingue des autres types d'arrondi.
• Utile pour les calculs financiers ou logiques : Lorsque l'on doit calculer des seuils minimaux, des index de pagination, des étages d'immeubles ou des tranches inférieures en finance (exemple : arrondir un prix au dollar inférieur), floor s'avère très utile pour garantir que l'on ne dépasse pas une limite.
• Permet de contrôler l'affichage numérique : Dans un contexte d'affichage, floor peut être utilisé pour présenter des données sans partie décimale, en particulier si la précision n'est pas nécessaire (par exemple, afficher «4 personnes» au lieu de «4,7»). Cela améliore la lisibilité pour l'utilisateur final.
• Particulièrement utile dans les boucles ou les divisions : Lorsqu'un calcul produit un résultat non entier (exemple : nombre_total / nombre_colonnes), floor permet de convertir le résultat en un index utilisable, notamment pour générer des positions dans une grille ou pour itérer sans risque d'erreur.
• Fonctionne sur des variables dynamiques ou des objets : On peut appliquer floor à des valeurs calculées dans Liquid, qu'elles proviennent d'une arithmétique (prix * taxe) ou de données dynamiques issues de formulaires ou d'enregistrements Dataverse. Cela permet de simplifier des valeurs issues d'entrées utilisateurs.
• Sécurise les comparaisons numériques : Dans certains cas, on souhaite comparer des valeurs numériques entières entre elles. En arrondissant au plancher avec floor, on s'assure de ne pas introduire d'écarts causés par les décimales lors d'une comparaison ou d'une condition logique ({% if x | floor > 3 %}).
• Ne modifie pas la valeur d'origine : Le filtre ne change pas la variable de base mais retourne une nouvelle valeur arrondie. Il peut donc être combiné avec d'autres filtres ou utilisé dans une affectation ({% assign prixArrondi = montant | floor %}), sans affecter les autres utilisations de montant.
• Complémentaire du filtre ceil pour les bornes : floor est souvent utilisé en tandem avec ceil (plafond) afin d'obtenir les encadrements entiers d'une valeur décimale. Cela est pratique pour gérer des intervalles, définir des bornes ou calibrer des limites numériques dans des interfaces utilisateur ou des contrôles.