Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

decimal.ROUND_HALF_UP — les égalités s’éloignent de zéro

decimal.ROUND_HALF_UP choisit le résultat le plus proche et, en cas d’égalité exacte, arrondit en s’éloignant de zéro, y compris pour les valeurs négatives.

Version : Python 3.14; repository image, production runtime not attested

Syntaxe

value.quantize(Decimal('0.01'), rounding=decimal.ROUND_HALF_UP)

decimal.ROUND_HALF_UP est une constante de mode d’arrondi, pas une fonction. Elle choisit la valeur la plus proche ; exactement à mi-chemin, elle choisit la valeur la plus éloignée de zéro. Cela ne signifie pas qu’on arrondit toujours vers l’infini positif.

Passez-la à quantize() avec l’argument rounding. Le modèle Decimal('0.01') indique deux chiffres après la virgule. Construisez les valeurs à partir de chaînes : la conversion depuis float conserve son approximation binaire.

Contrairement à ROUND_UP, ce mode n’arrondit pas toujours en s’éloignant de zéro. ROUND_HALF_EVEN départage les égalités en choisissant un dernier chiffre conservé pair. La précision du contexte limite toujours le résultat.

Exemples

import decimal

context = decimal.Context(prec=10)
for text in ('1.234', '1.235', '-1.235'):
    value = decimal.Decimal(text)
    result = value.quantize(
        decimal.Decimal('0.01'),
        rounding=decimal.ROUND_HALF_UP,
        context=context,
    )
    print(f'{text} -> {result}')

Résultat

1.234 -> 1.23
1.235 -> 1.24
-1.235 -> -1.24

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources