PythonのROUND_HALF_EVENは切り捨てではない:負数と境界値でHALF_UPと比較する

プログラミング・Web開発カテゴリを表すパンダのイラスト プログラミング・Web開発

この記事について
この記事は、生成AIを活用した自動生成フローで作成しています。Python公式decimalの丸め規則を確認し、正負の境界値を比較する独立したサンプルを構成しました。

検証ステータス:🧪 サンプルの計算を確認済み・実務の税額処理は未確認
正負の境界値を独立したサンプルで扱います。会計システムへの接続、税務適合性、Windows/macOS実機は未確認です。

PythonのROUND_HALF_EVENは切り捨てではない:負数と境界値でHALF_UPと比較する

2.5を整数へ丸めると、方式によって2にも3にもなります。しかし「HALF_EVENは切り捨て」「HALF_UPは常に切り上げ」という説明は、負の値や3.5を正しく扱えません。この記事では、正数と負数のちょうど中間にある値を独立したサンプルで比較し、境界値テストを作ります。

既存の20261116-06は明細単位か合計後かという計算順序が主題です。こちらは、同じ1つの値に適用する丸め方式だけを検証します。税率・数量・合計順序を混ぜないことで原因を切り分けます。

まず結論:2.5はどちらも3にはならない

ROUND_HALF_UPは、ちょうど半分に当たるとき、ゼロから離れる方向に丸めます。正の数の2.5なら3です。対してROUND_HALF_EVENは、ちょうど半分なら隣り合う候補のうち偶数になる方に寄せます。2.5なら2、3.5なら4です。2.5に対して「切り捨て」、3.5に対して「切り上げ」を行っているように見えますが、実際は「偶数の候補を選ぶ」という一貫したルールです。

丸める前の値HALF_UPで整数へHALF_EVENで整数へ何が違うか
1.522偶数側も2
2.532真ん中の候補が2と3
3.544偶数側も4
4.144真ん中ではない
4.554真ん中の候補が4と5

この表で最も大切なのは、HALF_EVENを「常に切り捨てる方式」だと思い込まないことです。偶数になる方が上側なら上へ丸めます。反対にHALF_UPは、正の数では一般的な「四捨五入」と同じ結果になりますが、負の値まで含めると「ゼロから遠ざける」が正確な説明です。

準備:独立したコードで正負の境界値を比較する

Python 3.10以降を想定します。標準ライブラリdecimalだけを使い、教材ファイル、実際の請求データ、外部通信、管理者権限は不要です。以下をrounding_modes.pyとして保存し、python rounding_modes.pyで実行します。

from decimal import Decimal, ROUND_HALF_EVEN, ROUND_HALF_UP

values = ["-3.5", "-2.5", "-1.5", "-1.4", "1.4", "1.5", "2.5", "3.5"]
for value in values:
    number = Decimal(value)
    up = number.quantize(Decimal("1"), rounding=ROUND_HALF_UP)
    even = number.quantize(Decimal("1"), rounding=ROUND_HALF_EVEN)
    print(f"{value:>4}: HALF_UP={up:>2} HALF_EVEN={even:>2}")

-2.5はHALF_UPで-3、HALF_EVENで-2になります。一方、-3.5は両方-4です。値を文字列からDecimalにするのは、浮動小数点の近似を境界値判定に混ぜないためです。Windowsでpythonが見つからなければpyを試し、インストールとPATHを確認します。

なぜ負数では説明が難しくなるのか

ROUND_HALF_UPは、ちょうど中間ならゼロから遠い側を選びます。2.5は3、-2.5は-3です。ROUND_HALF_EVENは偶数の候補を選ぶので、2.5も-2.5も絶対値2の側になります。

入力HALF_UPHALF_EVEN
-3.5-4-4
-2.5-3-2
-1.5-2-2
1.522
2.532
3.544

「切り上げ」「切り捨て」は負数ではゼロ方向か正方向かが曖昧です。方式名ではなく、-2.5と-3.5を含む期待値で規則を固定してください。

同点でない値と丸め桁は別に検証する

方式差が現れるのは、丸める桁に対して厳密に中間値のときです。2.49は両方2、2.51は両方3です。整数への丸めと小数第1位への丸めでは、境界値の位置が異なります。

from decimal import Decimal, ROUND_HALF_EVEN, ROUND_HALF_UP
for value in ("2.49", "2.50", "2.51"):
    x = Decimal(value)
    print(value, x.quantize(Decimal("1"), rounding=ROUND_HALF_UP),
          x.quantize(Decimal("1"), rounding=ROUND_HALF_EVEN))

期待出力は2.49 2 2、2.50 3 2、2.51 3 3です。丸め単位をDecimal("0.1")に変えると比較条件が変わります。丸め方式と丸め桁を同時に変更しないのが調査の基本です。

条件変更:-2.5を-3.5へ変える

-2.5から-3.5へ変えると、HALF_UPは-3から-4、HALF_EVENは-2から-4へ変わります。HALF_EVENは負数を常にゼロ方向へ寄せるのではなく、偶数を選んでいます。

次に2.5を2.5001へ変えると、両方式で3です。わずかに中間から外れたことが理由です。入力をfloatで計算してからDecimalへ変換した場合は、中間値かどうかを表示して確認してください。

境界値の自動テストと切り分け

import unittest
from decimal import Decimal, ROUND_HALF_UP, ROUND_HALF_EVEN

class RoundingRulesTest(unittest.TestCase):
    def test_ties(self):
        cases = [("2.5", "3", "2"), ("3.5", "4", "4"),
                 ("-2.5", "-3", "-2"), ("-3.5", "-4", "-4")]
        for raw, expected_up, expected_even in cases:
            with self.subTest(raw=raw):
                number = Decimal(raw)
                self.assertEqual(number.quantize(Decimal("1"), rounding=ROUND_HALF_UP), Decimal(expected_up))
                self.assertEqual(number.quantize(Decimal("1"), rounding=ROUND_HALF_EVEN), Decimal(expected_even))

if __name__ == "__main__":
    unittest.main()

test_rounding_rules.pyへ保存しpython -m unittest -v test_rounding_rules.pyで実行します。期待値が異なる場合は、丸め方式、丸め桁、入力がfloat由来か、計算途中で別の丸めが入ったかを順に確認します。Windows/macOSでの実行は未確認です。

業務での変更管理

HALF_EVENを銀行家の丸めと呼ぶことがありますが、すべての会計処理で採用すべきという意味ではありません。契約、制度、社内の計算仕様が優先します。丸め方式の変更申請では、丸め前の値、丸め桁、正負の境界値、期待結果、承認者、切戻し条件を記録してください。

明細ごとか合計後かの差は別記事20261116-06で扱います。計算順序と丸め方式を同時に変えると原因を切り分けられません。 テストは架空値で行い、実際の請求書や個人情報を入力しないでください。

まとめ

HALF_UPは中間値をゼロから遠ざけ、HALF_EVENは偶数側を選びます。-2.5と-3.5を並べると、「切り捨て」といった曖昧な説明を避けられます。境界値、同点以外、丸め桁を分けて試し、業務では承認済みの期待値と照合してください。

公式情報・一次情報

関連する教材

検証方法・未確認事項

Python標準decimalの公式仕様を参照し、正負の境界値とunittestを構成しました。Windows/macOS実機、実請求、税務適合性、WordPress表示は未確認です。

文書情報

記事タイトル
PythonのROUND_HALF_EVENは切り捨てではない:負数と境界値でHALF_UPと比較する
作成日
更新日
Source URL
https://papanda925.com/?p=18657

ライセンス: 本記事のうち、当サイトが権利を有する本文・自作図表は、特記なき限り CC BY 4.0 で利用できます。生成AIを活用して作成・編集した内容を含みます。コードについて、別途ライセンス表示またはリンク先GitHubリポジトリのライセンスがある場合は、その条件を優先します。引用・第三者資料・画像・商標等は本ライセンスの対象外です。 利用ポリシー

タイトルとURLをコピーしました