この記事について
この記事は、生成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.5 | 2 | 2 | 偶数側も2 |
| 2.5 | 3 | 2 | 真ん中の候補が2と3 |
| 3.5 | 4 | 4 | 偶数側も4 |
| 4.1 | 4 | 4 | 真ん中ではない |
| 4.5 | 5 | 4 | 真ん中の候補が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_UP | HALF_EVEN |
|---|---|---|
| -3.5 | -4 | -4 |
| -2.5 | -3 | -2 |
| -1.5 | -2 | -2 |
| 1.5 | 2 | 2 |
| 2.5 | 3 | 2 |
| 3.5 | 4 | 4 |
「切り上げ」「切り捨て」は負数ではゼロ方向か正方向かが曖昧です。方式名ではなく、-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を並べると、「切り捨て」といった曖昧な説明を避けられます。境界値、同点以外、丸め桁を分けて試し、業務では承認済みの期待値と照合してください。
公式情報・一次情報
関連する教材
- Daily-Code-SamplesのDecimal比較教材(税額相当値を使う別の教材。本記事の独立サンプルには不要)
検証方法・未確認事項
Python標準decimalの公式仕様を参照し、正負の境界値とunittestを構成しました。Windows/macOS実機、実請求、税務適合性、WordPress表示は未確認です。
