Python
PR

Pythonのf文字列(f-string)の使い方|書式指定・桁区切り・ゼロ埋めを実例で解説

Pythonのf文字列(f-string)の使い方|書式指定・桁区切り・ゼロ埋めを実例で解説
hr
記事内に商品プロモーションを含む場合があります

「合計 3600 円」のように、変数の値を文章に埋め込んで表示したい。金額に 3 桁ごとのカンマを付けたい、小数点以下を 2 桁にそろえたい、ID を「007」のようにゼロで埋めたい。Python でこうした文字列を作るときに一番よく使うのが f 文字列(f-string)です。

この記事では、f 文字列の基本から、デバッグに便利な {x=}、桁区切り・小数点・パーセント・幅と寄せ・ゼロ埋め・2 進数と 16 進数・日付の書式指定、Python 3.12 で緩和された制限、format() や % 書式との違いまでを、実行結果つきで説明します。載せている出力は、Windows 11・Python 3.12.6 で実際に実行して確かめたものです。

f 文字列とは

f 文字列は、引用符の前に f(または大文字の F)を付けた文字列です。中に { }(波かっこ)で囲んだ部分を書くと、その部分が実行したときの値に置き換わります。公式ドキュメントでは formatted string literal(フォーマット済み文字列リテラル)と呼ばれ、Python 3.6 で追加されました(PEP 498)。

次のコードを sample.py として保存します。

name = "佐藤"
age = 28
print(f"{name}さんは{age}歳です")
print(F"{name}さんは{age}歳です")
print("{name}さんは{age}歳です")

PowerShell で、保存したフォルダーに移動して実行します。

py sample.py
佐藤さんは28歳です
佐藤さんは28歳です
{name}さんは{age}歳です

3 行目は f を付け忘れた例で、エラーにならず {name} がそのまま出ます。「変数の値が出ずに波かっこごと表示される」ときは、まず f の付け忘れを疑ってください。

{ } の中には式や関数呼び出しも書ける

{ } の中に書けるのは変数名だけではありません。計算、関数の呼び出し、リストや辞書の要素、条件式(A if 条件 else B)など、値になる式なら書けます。

price = 1200
qty = 3
age = 28
items = ["りんご", "みかん", "ぶどう"]
user = {"name": "佐藤", "role": "admin"}
print(f"合計: {price * qty}円")
print(f"品数: {len(items)}")
print(f"先頭: {items[0]}")
print(f"名前: {user['name']}")
print(f"大文字: {'abc'.upper()}")
print(f"判定: {'成人' if age >= 20 else '未成年'}")
合計: 3600円
品数: 3
先頭: りんご
名前: 佐藤
大文字: ABC
判定: 成人

user['name'] のように、外側の " と違う種類の引用符(ここでは ')を中で使っているのがポイントです。同じ " を中で使えるようになったのは Python 3.12 からで、詳しくは後の「Python 3.12 で緩和された制限」で説明します。

ただし、長い処理は先に変数に入れてから埋め込むほうが読みやすくなります。

デバッグに便利な {x=}(Python 3.8 から)

式の後ろに = を付けると、「式の文字」「=」「値」をまとめて表示します。Python 3.8 で追加された機能で、変数の中身を確かめたいときに print(f"x={x}") と書く手間が省けます。

x = 10
y = 3
name = "佐藤"
print(f"{x=}")
print(f"{x / y = }")
print(f"{name=}")
print(f"{x / y = :.2f}")
print(f"{name = !s}")
x=10
x / y = 3.3333333333333335
name='佐藤'
x / y = 3.33
name = 佐藤
  • = の前後に書いた空白は、そのまま出力にも残ります(2 行目の x / y = )
  • 何も指定しないと、値は repr()(開発者向けの表現)で表示されるため、文字列には '佐藤' のように引用符が付きます。空文字列や末尾の空白にも気づきやすくなります
  • :.2f のような書式指定を付けると、引用符なしの str() の表示になります。!s を付けても引用符なしになります

ちょっとした動作確認なら print(f"{変数=}") がいちばん手軽です。

書式指定の基本:コロンの後ろに書く

{値:書式} のように、コロン(:)の後ろに書式を書くと、桁区切りや小数点以下の桁数などを指定できます。この書式の書き方は、公式ドキュメントで「書式指定ミニ言語(Format Specification Mini-Language)」と呼ばれています。書く順番は次のとおりで、どれも省略できます。

{値:[埋め文字][寄せ][符号][#][0][幅][桁区切り][.精度][型]}

よく使う組み合わせを目的別に見ていきます。

桁区切り・小数点・パーセント

n = 1234567
pi = 3.14159265
rate = 0.1234
print(f"{n:,}")
print(f"{n:_}")
print(f"{pi:.2f}")
print(f"{pi:.0f}")
print(f"{n:,.2f}")
print(f"{rate:%}")
print(f"{rate:.1%}")
print(f"{n:e}")
print(f"{n:.3e}")
1,234,567
1_234_567
3.14
3
1,234,567.00
12.340000%
12.3%
1.234567e+06
1.235e+06
書式意味例と結果
,3 桁ごとにカンマを入れる{1234567:,} → 1,234,567
_3 桁ごとにアンダースコアを入れる{1234567:_} → 1_234_567
.2f小数点以下 2 桁(f は固定小数点){3.14159265:.2f} → 3.14
,.2f桁区切り+小数点以下 2 桁{1234567:,.2f} → 1,234,567.00
.1%100 倍して % を付ける(小数点以下 1 桁){0.1234:.1%} → 12.3%
.3e指数表記(小数点以下 3 桁){1234567:.3e} → 1.235e+06

% は値を 100 倍してから表示します。0.1234 は「12.34%」になり、12.34 を渡すと「1234.000000%」になってしまうので、割合(0〜1)の値に使います。精度を付けない {rate:%} は小数点以下 6 桁になるため、普通は .1% のように桁数を指定します。

幅と寄せ(左寄せ・右寄せ・中央)

数字で「幅(何文字分の場所をとるか)」を指定し、<(左寄せ)・>(右寄せ)・^(中央)で寄せ方を指定します。埋まった範囲が分かるように、前後に [ ] を付けて表示します。

s = "abc"
print(f"[{s:10}]")
print(f"[{s:<10}]")
print(f"[{s:>10}]")
print(f"[{s:^10}]")
print(f"[{s:*^10}]")
print(f"[{42:10}]")
print(f"[{42:<10}]")
print(f"[{42:+}]")
[abc       ]
[abc       ]
[       abc]
[   abc    ]
[***abc****]
[        42]
[42        ]
[+42]
  • 寄せ方を書かないと、文字列は左寄せ、数値は右寄せになります(1 行目と 6 行目)
  • 寄せ方の前に 1 文字書くと、空白の代わりにその文字で埋めます(*^10)。中央にそろえられないときは、右側が 1 文字多くなります
  • 幅は「最低限の幅」です。値のほうが長いときは切り詰められず、そのまま全部表示されます
  • + を付けると、正の数にも符号が付きます

ゼロ埋め(05d・03d)

幅の前に 0 を付けると、空白の代わりに 0 で埋めます。連番のファイル名や ID を作るときによく使います。

print(f"[{42:05}]")
print(f"[{-42:05}]")
print(f"[{7:03d}]")
print(f"[{3.5:08.2f}]")
print(f"img_{7:03d}.png")
[00042]
[-0042]
[007]
[00003.50]
img_007.png

幅は符号や小数点も含めた全体の文字数です。-42 を幅 5 でゼロ埋めすると、マイナスの後ろに 0 が入って -0042 になります。08.2f も「小数点以下 2 桁で、全体 8 文字」という意味です。d は 10 進数の整数を表す型で、05 と 05d は整数に対しては同じ結果になります。

2 進数・8 進数・16 進数(b・o・x・X・#)

n = 255
print(f"{n:b}")
print(f"{n:o}")
print(f"{n:x}")
print(f"{n:X}")
print(f"{n:#b}")
print(f"{n:#x}")
print(f"{n:#X}")
print(f"{n:08b}")
print(f"{n:04x}")
print(f"{0xDEADBEEF:_x}")
print(f"{-1:x}")
print(f"{-1 & 0xFF:02x}")
11111111
377
ff
FF
0b11111111
0xff
0XFF
11111111
00ff
dead_beef
-1
ff
書式意味255 の結果
b2 進数11111111
o8 進数377
x / X16 進数(小文字 / 大文字)ff / FF
#b / #x接頭辞 0b・0x を付ける0b11111111 / 0xff
04x4 桁になるまで 0 で埋める00ff
_x4 桁ごとに _ を入れるff(0xDEADBEEF なら dead_beef)

負の数をそのまま x で表示すると -1 のようにマイナス付きになり、コンピューターの内部表現(2 の補数)の ff にはなりません。1 バイトとして見たいときは、-1 & 0xFF のように必要なビット数でマスクします。2 進数・16 進数の考え方は「2進数・16進数の基本」、手元で値を確かめたいときは 基数変換ツールが便利です(2 の補数の表示にも対応しています)。

なお、2 進数・16 進数の区切りに使えるのは _ だけで、, を指定するとエラーになります(後の「よくある間違い」で出力を載せています)。

日付と時刻({dt:%Y-%m-%d})

datetime のオブジェクトには、strftime と同じ %Y・%m などの書式をコロンの後ろにそのまま書けます。数値の書式指定ミニ言語とは別の書き方で、型ごとに書式の解釈を決められる仕組み(__format__)によるものです。

from datetime import datetime, date
dt = datetime(2026, 10, 18, 9, 5, 7)
print(f"{dt:%Y-%m-%d}")
print(f"{dt:%Y/%m/%d %H:%M:%S}")
print(f"{dt:%Y年%m月%d日}")
print(f"{date(2026, 1, 5):%m/%d}")
print(f"{dt}")
print(f"{dt!r}")
2026-10-18
2026/10/18 09:05:07
2026年10月18日
01/05
2026-10-18 09:05:07
datetime.datetime(2026, 10, 18, 9, 5, 7)

%m・%d は 2 桁になり、1 月 5 日は「01/05」です。日時の扱い(タイムゾーンや計算)は「Pythonのdatetimeの使い方」で詳しく説明しています。

!r・!s・!a で表示の形を変える

式の後ろに !r を付けると repr()、!s は str()、!a は ascii() で変換してから表示します。普段は何も付けなくて構いませんが、!r は「値の中身を正確に見たい」ときに役立ちます。

s = "佐藤"
print(f"{s}")
print(f"{s!s}")
print(f"{s!r}")
print(f"{s!a}")
path = "C:\\temp\\new"
print(f"{path}")
print(f"{path!r}")
empty = ""
print(f"[{empty}]")
print(f"[{empty!r}]")
佐藤
佐藤
'佐藤'
'\u4f50\u85e4'
C:\temp\new
'C:\\temp\\new'
[]
['']

!r では文字列に引用符が付き、バックスラッシュも Python のコードで書くときの形(\\)で表示されます。空文字列も '' と見えるので、「何も表示されないのは空文字列なのか、表示されていないだけなのか」を区別できます。!a は ASCII 以外の文字を \u の形にします。

波かっこ { } そのものを表示する:{{ }}

f 文字列の中で { や } を文字として表示したいときは、{{・}} と 2 つ重ねて書きます。JSON の例や、テンプレートの文字列を作るときに必要になります。

key = "id"
print(f"{{}}")
print(f"{{{key}}}")
print(f'{{"{key}": 1}}')
{}
{id}
{"id": 1}

{{{key}}} は、外側の {{・}} が文字の波かっこ、真ん中の {key} が値の埋め込みです。ただし、JSON を作るなら f 文字列で組み立てるより、json.dumps を使うほうが安全です(引用符や改行のエスケープを自動でしてくれます)。

Python 3.12 で緩和された制限(PEP 701)

Python 3.12 で f 文字列の文法が整理され(PEP 701)、{ } の中に書ける式の制限が大きく緩和されました。公式ドキュメントでは、次の 3 つについて「3.12 より前はできなかった」と書かれています。

  • 外側と同じ種類の引用符を、{ } の中で使うこと
  • { } の中にバックスラッシュ(\n など)を書くこと
  • { } の中にコメント(#)を書くこと

また 3.12 の「What’s New」には、3.11 では式を 1 行で書く必要があったが、3.12 からは複数行に分けてコメントも付けられると書かれています。次のコードは Python 3.12 では動きますが、3.11 以前では前半の 3 つの print が SyntaxError(構文エラー)になります。

user = {"name": "佐藤", "role": "admin"}
items = ["りんご", "みかん", "ぶどう"]
# 3.12 から書ける(3.11 以前は SyntaxError)
print(f"名前: {user["name"]}")
print(f"一覧:\n{"\n".join(items)}")
print(f"合計: {sum([
    100,  # 本体
    20,   # 送料
])}円")
# 3.11 以前でも書ける形
print(f"名前: {user['name']}")
nl = "\n"
print(f"一覧:{nl}{nl.join(items)}")

Python 3.12.6 での出力です。

名前: 佐藤
一覧:
りんご
みかん
ぶどう
合計: 120円
名前: 佐藤
一覧:
りんご
みかん
ぶどう

3.11 以前と同じ書き方は 3.12 でもそのまま動きます。サーバーや同僚の環境が 3.11 以前かもしれない場合は、中の引用符は外側と別の種類にする、改行文字などは先に変数に入れる、という 3.11 以前の書き方にしておくと安心です。自分の Python のバージョンは py --version(Linux や macOS では python3 --version)で確認できます。なお、筆者の PC には Python 3.11 以前が入っていないため、3.11 以前で出るエラーメッセージの文面は確認できていません。

format() や % 書式との違い

f 文字列のほかに、str.format() と % 書式という書き方もあり、古いコードでよく見かけます。

name = "佐藤"
price = 1234.5
print(f"{name}さん: {price:,.1f}円")
print("{}さん: {:,.1f}円".format(name, price))
print("{n}さん: {p:,.1f}円".format(n=name, p=price))
print("%sさん: %.1f円" % (name, price))
print(format(price, ",.1f"))
template = "{name}さん、こんにちは"
print(template.format(name="田中"))
佐藤さん: 1,234.5円
佐藤さん: 1,234.5円
佐藤さん: 1,234.5円
佐藤さん: 1234.5円
1,234.5
田中さん、こんにちは
書き方特徴向いている場面
f 文字列
f"{name}"
値を書く場所に直接式を書ける。読みやすい。Python 3.6 以降ふだんの文字列の組み立て全般
str.format()
"{}".format(name)
書式は f 文字列と同じミニ言語。テンプレートと値を別々に用意できるテンプレートを先に作っておき、後から値を入れるとき
% 書式
"%s" % name
C 言語の printf に近い古い書き方。%.1f に桁区切りの指定はない古いコードを読むとき。logging のメッセージ(logger.info("%s", x))
format() 関数
format(x, ",.1f")
値 1 つだけを書式指定で文字列にする書式を変数で受け取って値を整えるとき

f 文字列は、書いたその場で変数の値を読み込みます。そのため、「テンプレートを設定ファイルに書いておき、後で値を入れる」ような使い方はできません。この場合は、最後の例のように str.format() を使います。ただし、利用者が入力した文字列をテンプレートとして format() に渡すと、オブジェクトの属性などを読み出される危険があるため、テンプレートはプログラム側で用意したものだけにしてください。

よくある間違い・エラー

文字列のままの数字に , や .2f を付けた

input() やファイル、CSV から読み込んだ値は、見た目が数字でも文字列(str)です。文字列に数値用の書式を付けると ValueError になります。

price = "1200"
print(f"{price:,}円")
Traceback (most recent call last):
  File "C:\...\sample.py", line 2, in <module>
    print(f"{price:,}円")
            ^^^^^^^^^
ValueError: Cannot specify ',' with 's'.

「’s’(文字列の書式)に ‘,’ は指定できない」という意味です。{int(price):,} のように数値に変換してから書式を付けます。ほかにも、書式と値の型が合わないと次のようなエラーになります(Python 3.12.6 で確認)。

コードエラーメッセージ直し方
f"{'3.5':.2f}"Unknown format code ‘f’ for object of type ‘str’float() で数値にする
f"{3.5:d}"Unknown format code ‘d’ for object of type ‘float’小数は .0f を使うか、int() で整数にする
f"{10:.2d}"Precision not allowed in integer format specifier整数に精度は付けられない。.2f にする
f"{1234:,x}"Cannot specify ‘,’ with ‘x’.16 進数の区切りは _x を使う

波かっこの閉じ忘れ・1 つだけの }

f 文字列の書き間違いは、実行前に SyntaxError として見つかります。Python 3.12.6 では次のメッセージになりました。

コードエラーメッセージ原因
f"{name"f-string: expecting ‘}’閉じる } がない
f"{}"f-string: valid expression required before ‘}’{ } の中が空。波かっこを表示したいなら {{}}
f"set: {1, 2}}"f-string: single ‘}’ is not allowed} が 1 つ余っている。文字として出すなら }}
f"{x!z}"f-string: invalid conversion character ‘z’: expected ‘s’, ‘r’, or ‘a’! の後ろに書けるのは s・r・a だけ

.2f の丸めが「四捨五入」にならない

from decimal import Decimal
print(f"{2.675:.2f}", f"{2.5:.0f}", f"{3.5:.0f}")
print(f"{Decimal('2.675'):.2f}")
2.67 2 4
2.68

2.675 を小数点以下 2 桁にすると、2.68 ではなく 2.67 になります。float は内部では 2 進数で表すため、2.675 は実際には 2.67499999… のような値になっているからです。また、2.5 が 2 に、3.5 が 4 になるように、ちょうど半分のときは偶数の側に丸められます(公式ドキュメントでは、round() 関数と同じ丸め方と説明されています)。金額など、10 進数のとおりに四捨五入したいときは、文字列から作った Decimal を使い、丸め方を指定して計算してから表示します。

日本語(全角文字)を含むと表の列がずれる

幅の指定は「文字数」で数えます。画面での見た目の幅ではないため、全角文字が混ざると列がずれます。

import unicodedata

rows = [("apple", 120), ("りんご", 120), ("リンゴ", 120)]
for name, price in rows:
    print(f"|{name:<10}|{price:>5}|")

for ch in "aりリ1":
    print(ch, unicodedata.east_asian_width(ch))


def width(s):
    return sum(2 if unicodedata.east_asian_width(c) in "FW" else 1 for c in s)


def ljust_w(s, n):
    return s + " " * (n - width(s))


for name, price in rows:
    print(f"|{ljust_w(name, 10)}|{price:>5}|")
|apple     |  120|
|りんご       |  120|
|リンゴ      |  120|
a Na
り W
リ H
1 F
|apple     |  120|
|りんご    |  120|
|リンゴ      |  120|

最初の 3 行では、「りんご」も 10 文字分(3 文字+空白 7 個)になっていますが、全角文字は画面で半角 2 文字分の幅をとるため、ターミナルでは 3 文字分右にはみ出します。(このページ上ではフォントによりずれ方が違って見えることがあります。)

標準ライブラリの unicodedata.east_asian_width() を使うと、文字ごとの幅の分類が分かります。W(全角)と F(全角英数など)は 2 文字分、Na(半角英数)と H(半角カナ)は 1 文字分として数えると、後半の 3 行のようにそろいます。ただし、○ や ①、ギリシャ文字などは A(曖昧)に分類され、環境やフォントによって幅が 1 にも 2 にもなるので、この方法でも完全にはそろいません。絵文字の幅も環境しだいです。きっちりそろえたい表は CSV や HTML で出力するほうが確実です。

文字数とバイト数の違いを確かめたいときは、文字数・バイト数カウントに文字列を貼ると、文字数と UTF-8・Shift_JIS でのバイト数を一度に確認できます。

よくある質問

f と r を組み合わせられますか?

できます。rf"..." または fr"..." と書くと、バックスラッシュをエスケープとして扱わない raw 文字列のまま、{ } で値を埋め込めます。Windows のパスや正規表現のパターンを組み立てるときに使います。正規表現の書き方は「Pythonの正規表現入門」を参照してください。

SQL 文を f 文字列で組み立ててもよいですか?

利用者の入力を f 文字列で SQL 文に埋め込むのはやめましょう。入力に ' などが含まれると SQL 文の意味が変わってしまう「SQL インジェクション」の原因になります。sqlite3 なら cur.execute("SELECT * FROM users WHERE name = ?", (name,)) のように、値をプレースホルダー(?)で渡します。詳しくは「SQLインジェクションとは」で説明しています。

まとめ

  • f 文字列は f"...{式}..."。f の付け忘れに注意
  • 動作確認には {x=}(3.8 から)。値の中身を正確に見たいときは !r
  • よく使う書式:,(桁区切り)、.2f(小数点以下 2 桁)、.1%、<10・>10・^10(幅と寄せ)、05d(ゼロ埋め)、#x・08b(16 進数・2 進数)、%Y-%m-%d(日付)
  • 波かっこそのものは {{・}}
  • 同じ引用符・バックスラッシュ・コメントを { } の中で使えるのは 3.12 から

関連する記事・ツール

ABOUT ME
hr
hr
エンジニアとして働いている hr です。仕事や資格勉強で「こんなツールがあれば」と感じたものを、無料Webツールと解説記事にして発信しています。
記事URLをコピーしました