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で確認」でも扱っています。

あわせて読みたい

対面・無料|東京・永田町で毎週土曜日13時

この記事のようなコードを、講師に聞きながら動かしてみる

ゼロからはじめるPython入門講座

8年間・累計600回開催/これまで全国で2万人以上が参加

「やはり対面で聞けるのはとても気づきがあり、価値があると思います」

参加者の声

  • 本当に初心者からの講座です。プログラミングに触ったことがなくて大丈夫です
  • 対面だから、その場で聞けます。つまずいた所を持ち帰らずに解決できます
  • 講座は1時間。そのあとも残って学習を続けられ、講師にも質問できます
  • 独学で挫折した方も。糸口が見つかって、講座のあと会員になる方が多くいます

無料で参加する|開催日程を見る

参加費は無料です