Aller au contenu principal
Version: Next

NumberHelper

parse

BigDecimal NumberHelper.parse(Object value)

Description

Permet de convertir un objet vers un nombre représenté par le type BigDecimal.

Paramètres

  • value l'objet que l'on souhaite convertir en nombre. Il peut être un BigDecimal, BigInteger, Integer, Double, Long, String ou une variable de type Nombre.

Retour

Une valeur nombre correspondante à la valeur de l'objet en entrée value ou null.

Exemples
// VARIABLE_NUMBER = 3.14
NumberHelper.parse(VARIABLE_NUMBER.value) // = 3.14
NumberHelper.parse(VARIABLE_NUMBER) // = 3.14
NumberHelper.parse(13) // = 13
NumberHelper.parse("2023") // = 2023
NumberHelper.parse(DateHelper.today()) // = null

min

BigDecimal NumberHelper.min(List<VariableNumber> list)
BigDecimal NumberHelper.min(Object... list)

Description

Permet de retourner le nombre (le plus petit) parmi une liste de nombres.

Deux signatures possibles :

  • appliquer min sur les instances d'une variable multiple de type Nombre.
  • appliquer min sur une liste d'objets convertibles vers un nombre (grâce à la fonction parse)

Paramètres

  • list une variable multiple de type Nombre ou bien une liste d'objets convertibles vers un nombre séparés par des virgules.

Retour

Le nombre minimum parmi les instances de la variable multiple de type Nombre ou bien la liste des objets convertibles vers un nombre.

Exemples
// VARIABLE_AGES = [33, 31, 5]
NumberHelper.min(VARIABLE_AGES) // = 5
NumberHelper.min("3.14", 2023) // = 3.14

max

BigDecimal NumberHelper.max(List<VariableNumber> list)
BigDecimal NumberHelper.max(Object... list)

Description

Permet de retourner le nombre maximum (le plud grand) parmi une liste de nombres.

Deux signatures possibles :

  • appliquer max sur les instances d'une variable multiple de type Nombre.
  • appliquer max sur une liste d'objets convertibles vers un nombre (grâce à la fonction parse)

Paramètres

  • list une variable multiple de type Nombre ou bien une liste d'objets convertibles vers un nombre séparés par des virgules.

Retour

Le nombre maximum parmi les instances de la variable multiple de type Nombre ou bien la liste des objets convertibles vers un nombre.

Exemples
// VARIABLE_AGES = [33, 31, 5]
NumberHelper.max(VARIABLE_AGES) // = 33
NumberHelper.max("3.14", 2023) // = 2023

sum

BigDecimal NumberHelper.sum(List<VariableNumber> list)
BigDecimal NumberHelper.sum(Object... list)

Description

Permet de calculer la somme d'une liste de nombres.

Deux signatures possibles :

  • calculer la somme des instances d'une variable multiple de type Nombre.
  • calculer la somme d'une liste d'objets convertibles vers un nombre (grâce à la fonction parse)

Paramètres

  • list une variable multiple de type Nombre ou bien une liste d'objets convertibles vers un nombre séparés par des virgules.

Retour

Un nombre représentant la somme.

Exemples
// VARIABLE_AGES = [33, 31, 5]
NumberHelper.sum(VARIABLE_AGES) // = 69
NumberHelper.sum("1", 2, "3", 4) // = 10

product

BigDecimal NumberHelper.product(List<VariableNumber> list)
BigDecimal NumberHelper.product(Object... list)

Description

Permet de calculer le produit (multiplication) d'une liste de nombres.

Deux signatures possibles :

  • calculer le produit des instances d'une variable multiple de type Nombre.
  • calculer le produit d'une liste d'objets convertibles vers un nombre (grâce à la fonction parse)

Paramètres

  • list une variable multiple de type Nombre ou bien une liste d'objets convertibles vers un nombre séparés par des virgules.

Retour

Un nombre représentant le produit.

Exemples
// VARIABLE_AGES = [33, 31, 5]
NumberHelper.product(VARIABLE_AGES) // = 5115
NumberHelper.product("1", 2, "3", 4) // = 24

average

BigDecimal NumberHelper.sum(List<VariableNumber> list)
BigDecimal NumberHelper.sum(Object... list)

Description

Permet de calculer la moyenne d'une liste de nombres.

Deux signatures possibles :

  • calculer la moyenne des instances d'une variable multiple de type Nombre.
  • calculer la moyenne d'une liste d'objets convertibles vers un nombre (grâce à la fonction parse)

Paramètres

  • list une variable multiple de type Nombre ou bien une liste d'objets convertibles vers un nombre séparés par des virgules.

Retour

Un nombre représentant la moyenne.

Exemples
// VARIABLE_AGES = [33, 31, 5]
NumberHelper.average(VARIABLE_AGES) // = 23
NumberHelper.average("1", 2, "3", 4) // = 3.3333333333333333

floorDiv

BigDecimal NumberHelper.floorDiv(Object number, Object divisor)

Description

Permet de calculer une division entière. Renvoie le nombre le plus grand inférieur ou égal au quotient algébrique.

Paramètres

  • number le numérateur
  • division le dénominateur

Retour

Un nombre entier représentant le quotient de la division entière.

Exemples
NumberHelper.floorDiv(6, 3) // = 2
NumberHelper.floorDiv(7, 3) // = 2
NumberHelper.floorDiv(8, 3) // = 2
NumberHelper.floorDiv(9, 3) // = 3