Python Decimalへの変換|文字列・float・intからの作り方と、str・int・floatへ戻す方法
PythonでDecimalに変換するときは、文字列からDecimal('0.1')のように作るのが原則です。floatを直接Decimal(0.1)に渡すと誤差ごと取り込まれるため、floatしかない場合はDecimal(str(f))を使い、Decimalから戻すときは保存・表示にはstr()、整数が欲しいときはint()(切り捨て)を使います。
この記事は、Decimal()コンストラクタと型変換に絞った解説です。文字列・float・int・JSONからDecimalを作る方法、Decimalを文字列・float・intに戻す方法、変換で起きるエラーと落とし穴を、Python 3.12で実行した結果つきでまとめます(2026年10月18日確認)。Decimalでの計算や精度の設定まで含めた全体像は「Python decimalの使い方|floatの誤差をなくす計算と精度・四捨五入・float/int変換」を参照してください。
変換の早見表
| やりたいこと | 書き方 | 注意点 |
|---|---|---|
| 文字列 → Decimal | Decimal('1.5') |
書いたとおりの値になる。いちばん安全 |
| int → Decimal | Decimal(100) |
整数は誤差がないのでそのまま渡してよい |
| float → Decimal | Decimal(str(f)) |
Decimal(f)はfloatの誤差まで取り込む |
| JSON → Decimal | json.loads(s, parse_float=Decimal) |
floatを経由せずに読める |
| Decimal → 文字列 | str(d) |
末尾の0も保たれる。保存はこれ |
| Decimal → float | float(d) |
ここで誤差が入る可能性がある |
| Decimal → int | int(d) |
0の方向へ切り捨て(四捨五入ではない) |
文字列からDecimalに変換する
from decimal import Decimal
print(Decimal('1.5'))
print(Decimal(' -0.001 '))
print(Decimal('1e3'))
print(Decimal('1_000.25'))
実行結果:
1.5
-0.001
1E+3
1000.25
文字列で渡すと、書いた数字がそのままDecimalになります。前後の空白は無視され、1e3のような指数表記も読めます。Python 3.6からは1_000.25のように桁区切りのアンダースコアも使えます(Python公式ドキュメント decimal、2026年10月18日確認)。
カンマ付きの金額や入力値を変換する
「1,280」のようなカンマは読めないので、取り除いてから渡します。読めない文字列はValueErrorではなくdecimal.InvalidOperationになる点に注意してください。
from decimal import Decimal, InvalidOperation
def to_decimal(s):
try:
return Decimal(s.replace(',', '').strip())
except InvalidOperation:
raise ValueError(f"数値として読めません: {s!r}")
print(to_decimal("1,280"))
print(to_decimal(" 3.50 "))
try:
to_decimal("1.2.3")
except ValueError as e:
print("ValueError:", e)
print(Decimal("NaN"), Decimal("Infinity"))
実行結果:
1280
3.50
ValueError: 数値として読めません: '1.2.3'
NaN Infinity
"NaN"や"Infinity"はエラーにならず、そのままDecimalの特殊な値になります。金額の入力欄などで受け付けたくない場合は、変換後にd.is_finite()で確かめてください。
floatからDecimalに変換する
ここがDecimalの変換でいちばん間違えやすいところです。
from decimal import Decimal
print(Decimal(0.1))
print(Decimal('0.1'))
print(Decimal(str(0.1)))
print(Decimal.from_float(0.1) == Decimal(0.1))
実行結果:
0.1000000000000000055511151231257827021181583404541015625
0.1
0.1
True
floatの0.1は、2進数では正確に表せないため、実際には0.1000000000000000055…という値を持っています。Decimal(0.1)はその値を正確に写し取るので、誤差もいっしょにDecimalになります。Decimalにしたから誤差が消える、ということはありません。
floatしか手元にないときは、str()で文字列にしてから渡します。str(0.1)は'0.1'になるので、意図した値に戻ります。Decimal.from_float()はDecimal(float)と同じ結果で、誤差は消えません。
floatの混入をエラーで検出する
大きなプログラムでは、どこかでDecimal(0.1)のような書き方が紛れ込みます。FloatOperationのトラップを有効にすると、floatを渡した時点で例外にできます。
from decimal import Decimal, getcontext, FloatOperation
ctx = getcontext()
ctx.traps[FloatOperation] = True
try:
Decimal(0.1)
except FloatOperation as e:
print("FloatOperation:", type(e).__name__)
print(Decimal('0.1'))
実行結果:
FloatOperation: FloatOperation
0.1
公式ドキュメントでは、このトラップは既定では無効と書かれています。金額を扱うモジュールのテストで有効にしておくと、floatの混入を見つけやすくなります。
JSONの数値をDecimalで読む
json.loads()は小数をfloatとして読むため、そのままでは誤差が入ります。parse_float=Decimalを指定すると、floatを経由せずDecimalで受け取れます。
import json
from decimal import Decimal
text = '{"price": 0.1, "qty": 3}'
data = json.loads(text, parse_float=Decimal)
print(data)
print(data["price"] * data["qty"])
def default(o):
if isinstance(o, Decimal):
return str(o)
raise TypeError
print(json.dumps({"total": Decimal("0.30")}, default=default))
try:
json.dumps({"total": Decimal("0.30")})
except TypeError as e:
print("TypeError:", e)
実行結果:
{'price': Decimal('0.1'), 'qty': 3}
0.3
{"total": "0.30"}
TypeError: Object of type Decimal is not JSON serializable
逆に、Decimalはそのままではjson.dumps()できません。defaultで文字列にして書き出すのが安全です。
Decimalを文字列・float・intに戻す
from decimal import Decimal
d = Decimal('1234.50')
print(str(d))
print(f"{d:,}")
print(f"{d:.1f}")
print(float(d))
print(int(Decimal('-1.9')))
print(d.to_integral_value(), Decimal('2.5').to_integral_value())
実行結果:
1234.50
1,234.50
1234.5
1234.5
-1
1234 2
str()は末尾の0(.50)まで残します。DBやファイルに保存するときはこれを使います- f文字列の
:,で3桁区切り、:.1fで桁数指定もできます float()は計算に使うと誤差が入る可能性があります。グラフ描画など、誤差を気にしない用途に限りますint()は0の方向へ切り捨てるので、-1.9は-1になりますto_integral_value()は既定で偶数丸め(ROUND_HALF_EVEN)なので、2.5は2になります
決まった桁数で四捨五入したいときはquantize()を使います。「Python Decimalのquantize()の使い方」と「Python decimalの丸めモード8種類」で詳しく説明しています。
末尾の0と指数表記
from decimal import Decimal
a = Decimal('1.50')
b = Decimal('1.5')
print(a, b, a == b)
print(a.normalize())
print(Decimal('100').normalize(), Decimal('1E+2') == Decimal('100'))
print(Decimal((0, (3, 1, 4), -2)))
print(Decimal('3.14').as_tuple())
実行結果:
1.50 1.5 True
1.5
1E+2 True
3.14
DecimalTuple(sign=0, digits=(3, 1, 4), exponent=-2)
Decimalは値だけでなく桁数(指数)の情報も持っています。'1.50'と'1.5'は等しいのに表示は違い、normalize()で末尾の0を消せます。ただしDecimal('100').normalize()は1E+2になるので、表示用に使うと思わぬ形になります。表示をそろえたいならquantize()のほうが確実です。
タプル(符号, 数字の並び, 指数)からDecimalを作ることもでき、as_tuple()で中身を確認できます。
floatと混ぜたときの挙動
from decimal import Decimal
try:
Decimal('0.1') + 0.2
except TypeError as e:
print("TypeError:", e)
print(Decimal('0.1') + 2)
print(Decimal('0.1') == 0.1, Decimal('0.5') == 0.5)
実行結果:
TypeError: unsupported operand type(s) for +: 'decimal.Decimal' and 'float'
2.1
False True
Decimalとfloatの足し算はTypeErrorになりますが、intとは計算できます。比較は型をまたいでも行われ、Decimal('0.1') == 0.1はFalseです。floatの0.1が本当の0.1ではないためで、0.5のように2進数で正確に表せる値ならTrueになります。
よくある質問
Q. Decimal(0.1)とDecimal(‘0.1’)は何が違いますか?
Decimal(0.1)はfloatの0.1が実際に持っている値(0.1000000000000000055…)をそのまま変換します。Decimal(‘0.1’)は文字列に書いたとおりの0.1になります。誤差を避けたいなら文字列から作ります。
Q. floatの値をDecimalに正しく変換するには?
Decimal(str(f))のように、いったん文字列にしてから渡します。Decimal.from_float(f)やDecimal(f)は誤差ごと取り込むので、期待した値になりません。
Q. 文字列をDecimalに変換するとエラーになるのはなぜですか?
カンマや全角数字、小数点が2つあるなど、数値として読めない文字列を渡すとdecimal.InvalidOperationが出ます。ValueErrorではないので、exceptではInvalidOperationを指定します。
Q. Decimalをintに変換すると四捨五入されますか?
されません。int()は0の方向への切り捨てで、Decimal(‘1.9’)は1、Decimal(‘-1.9’)は-1になります。四捨五入したいときはquantize()でROUND_HALF_UPを指定してからint()にします。
まとめ
- Decimalは文字列から作るのが原則。整数はそのまま渡してよい
Decimal(0.1)はfloatの誤差を取り込む。floatしかないならDecimal(str(f))- 読めない文字列は
InvalidOperation。カンマは先に取り除く - JSONは
parse_float=Decimalで読み、書き出しはstr() - 戻すときは保存・表示に
str()、int()は切り捨て、float()は誤差に注意
なぜfloatで誤差が出るのかは「数値計算の誤差とは?丸め誤差・打切り誤差・桁落ち・情報落ちの例をPythonで確認」でも扱っています。


![Pythonの型ヒントでlist・dict・tupleを書く方法|list[int]・dict[str, int]の早見表とList・Dictとの違い Gemini_Generated_Image_xmxzrsxmxzrsxmxz](/wp-content/uploads/2026/09/Gemini_Generated_Image_xmxzrsxmxzrsxmxz-150x150.jpg)



