CEIL |
Conversion de l'entier supérieur ou égale |
| BigQuery |
Syntaxe
Paramètres
| Nom |
Description |
| X |
Ce paramètre permet de spécifier la valeur numérique (généralement un type à virgule flottante comme FLOAT64 ou NUMERIC) pour laquelle vous souhaitez obtenir l'entier le plus petit qui est supérieur ou égal à cette valeur. |
Description
Cette fonction permet de demander la valeur maximale d'un nombre, soit l'entier le plus proche supérieur ou égal au nombre.
Remarques
- Fonction d'arrondi vers le haut : La fonction CEIL(X) renvoie le plus petit entier supérieur ou égal à la valeur fournie. Par exemple, CEIL(3.2) retourne 4,
car c'est l'entier immédiatement supérieur à 3.2. Cette fonction est idéale pour forcer une arrondie vers le haut, indépendamment de la partie décimale.
- Différente de la fonction ROUND : Contrairement à ROUND, qui arrondit à l'entier le plus proche selon la valeur décimale, CEIL ignore complètement la règle
des 0.5 : elle arrondit toujours vers le haut, même pour CEIL(3.000001) qui donnera 4. Ce comportement est utile pour assurer une couverture ou une marge de sécurité.
- Fonction inverse de FLOOR : CEIL est le pendant de FLOOR, qui arrondit toujours vers le bas. Par exemple, CEIL(-2.5) retourne -2, alors que FLOOR(-2.5)
retourne -3. Cette distinction est importante dans les contextes où la direction de l'arrondi influence des calculs financiers ou logistiques.
- Fonction compatible avec plusieurs types numériques : CEIL peut être utilisée avec des types FLOAT64, NUMERIC, et BIGNUMERIC. Toutefois, son résultat est
toujours un type numérique entier du même type ou convertible sans perte. Attention à ne pas l'utiliser sur des chaînes ou des dates sans conversion préalable.
- Utile pour des cas de tarification ou de quotas : Dans des systèmes de facturation, CEIL est très utile pour calculer un nombre minimal d'unités
facturables. Par exemple, si chaque tranche de 5 Go est facturée, et qu'un utilisateur a consommé 13 Go, CEIL(13 / 5) retournera 3, ce qui permet de le facturer sur
trois unités.
- Impact neutre sur les entiers déjà arrondis : Lorsqu'on utilise CEIL sur un nombre entier (CEIL(5.0)), le résultat reste identique. Il n'y a donc pas de
transformation si la valeur est déjà entière, ce qui en fait une fonction sûre à appliquer sans risquer d'introduire une modification inutile.
- Peut être utilisée dans des expressions conditionnelles : CEIL s'intègre facilement dans des expressions SELECT, WHERE, ou CASE. Par exemple, on peut
décider de valider un panier d'achat uniquement si le total arrondi vers le haut dépasse un certain seuil, ce qui assure une marge minimale.
- Comportement prévisible avec les nombres négatifs : Avec des valeurs négatives, CEIL reste cohérente : elle retourne l'entier supérieur (le moins négatif).
Par exemple, CEIL(-4.3) donnera -4. Ce comportement est important à maîtriser car il diffère de l'intuition qu'on peut avoir lorsqu'on pense «arrondi vers le haut» au
sens visuel.
Dernière mise à jour : Jeudi, le 18 Juin 2020