Python f-string書式指定｜全項目の早見表と実行結果・3.14対応

f-string（f文字列）の書式指定とは、f"{値:書式}" のようにコロンの後ろに書く「書式指定ミニ言語」で、桁区切り・ゼロ埋め・寄せ・小数の桁数・進数などを1行で指定する仕組みです。 例えば f"{1234567.891:,.2f}" は '1,234,567.89' になります。

この記事では、書式指定ミニ言語の全項目（fill／align／sign／z／#／0／width／grouping／.precision／type）を「コード→出力」の早見表にまとめ、日付、= デバッグ、!r、幅の変数指定、Decimal、全角文字の幅ずれ対策まで紹介します。出力はすべて Python 3.13.7 で実際に実行した結果です。さらに、3.11と3.12で同じコードを動かして比較した PEP 701 の変更点と、3.14.7で動かした小数部の桁区切り・t-string も載せています。

f-string書式指定の早見表

まずはこの表で用が足ります。 n = 1234567.891、i = 255、x = 42、s = "abc"、r = 0.4567 として実行した結果です。

書式指定ミニ言語の構造

書式は「埋め文字・寄せ・符号・z・#・0・幅・区切り・.精度・型」の順に、必要なものだけ書きます。 公式ドキュメント（Python 3.14）の文法は次のとおりです。

format_spec:  [options][width_and_precision][type]
options:      [[fill]align][sign]["z"]["#"]["0"]
fill:         <任意の1文字>
align:        "<" | ">" | "=" | "^"
sign:         "+" | "-" | " "
width_and_precision: [width][grouping]["." [precision][grouping]]
grouping:     "," | "_"
type:         "b" | "c" | "d" | "e" | "E" | "f" | "F" | "g" | "G" | "n" | "o" | "s" | "x" | "X" | "%"

例えば f"{-1234.5:_>12,.1f}" は次のように分解できます。

print(f"{-1234.5:_>12,.1f}")

____-1,234.5

順番を入れ替えると ValueError になるので、「寄せ→符号→0→幅→区切り→精度→型」の並びを覚えておくと迷いません。

項目別の完全一覧（コード→出力）

以下、すべて Python 3.13.7 で実行した出力です。変数は n = 1234567.891、i = 255、x = 42、neg = -42、s = "abc"、r = 0.4567 です。

fill と align：寄せと埋め文字

埋め文字を指定するときは、必ず寄せ記号（<>^=）とセットで書きます。

sign と z：符号の表示

z は集計表で「-0.00」が出てしまうときに便利です（浮動小数点の表示型のみ）。

# と 0：進数の接頭辞とゼロ埋め

幅は「符号・小数点・区切り文字を含めた全体の文字数」です。f"{3.14159:08.3f}" は 3.142 の5文字に0を3つ足して8文字になります。

width と grouping：幅と桁区切り

, は10進数専用、_ は2・8・16進数では4桁ごとに入ります。

.precision：精度（小数の桁数・切り詰め）

.3 と .3f は意味が違います。 .3 は「有効数字3桁」、.3f は「小数点以下3桁」です。

type：表示型の一覧

• f は既定で小数6桁、% も同じく6桁です。桁数は .2f .1% のように指定します。
• g は「有効数字6桁」で、桁が大きい・小さいと自動で指数表記になります。12.0 を 12 と表示したいときにも使えます。

n：ロケールに合わせた区切り

n は、locale.setlocale() で設定した地域の区切り文字を使います。 既定のCロケールでは区切りが付きません。ロケールを生成した環境で実行した結果です。

import locale

for loc in ["ja_JP.UTF-8", "en_US.UTF-8", "de_DE.UTF-8"]:
    locale.setlocale(locale.LC_ALL, loc)
    print(loc, f"{1234567:n}", f"{1234567.891:.10n}")

ja_JP.UTF-8 1,234,567 1,234,567.891
en_US.UTF-8 1,234,567 1,234,567.891
de_DE.UTF-8 1.234.567 1.234.567,891

n は g と同じ「有効数字」扱いなので、小数を出すときは .10n のように桁を多めに指定します。サーバーのロケール設定に左右されるため、日本向けの表示で固定したいなら , を使うほうが確実です。

日付の書式指定（strftime を f-string で）

datetime を f-string に入れると、コロンの後ろに strftime の書式をそのまま書けます。 dt = datetime(2026, 9, 28, 14, 5, 9, 123456) で実行した結果です。

from datetime import datetime

dt = datetime(2026, 9, 28, 14, 5, 9, 123456)
print(f"{dt:%Y-%m-%d}")
print(f"{dt:%Y年%m月%d日}")
print(f"{dt:%Y-%m-%d} {dt.month}月{dt.day}日")
print(f"{dt=:%Y-%m-%d}")

2026-09-28
2026年09月28日
2026-09-28 9月28日
dt=2026-09-28

よく使う日付の書式指定子

• 月や日を0埋めなしで出したいときは、{dt.month}月{dt.day}日 と属性を直接書くのがどのOSでも動く方法です（%-m はWindowsでは使えません）。
• %a %b %c はロケールで変わります。ja_JP.UTF-8 を設定すると %a %b は 月 9月 になりました。
• timedelta には strftime 書式が使えません。 f"{timedelta(hours=1):%H:%M}" は TypeError: unsupported format string passed to datetime.timedelta.__format__ になります。

= でデバッグ表示（Python 3.8以降）

{変数=} と書くと「式のテキスト＝値」を出力します。 print デバッグで変数名を二度書かずに済みます。

price = 1980
name = "ボールペン"
rate = 0.12345
print(f"{price=}")
print(f"{price = }")
print(f"{rate=:.2%}")
print(f"{name=}")
print(f"{name=!s}")
print(f"{price*2=}")
print(f"{len(name)=}")

price=1980
price = 1980
rate=12.35%
name='ボールペン'
name=ボールペン
price*2=3960
len(name)=5

= を使うと既定で repr（!r）表示になるので、文字列はクォート付きになります。書式指定（:.2%）を付けるとそちらが優先され、!s を付けるとクォートなしになります。= の前後の空白もそのまま出力されます。

!r・!s・!a：変換フラグ

!r は repr()、!s は str()、!a は ascii() を通してから表示します。

class Item:
    def __init__(self, name):
        self.name = name
    def __str__(self):
        return f"商品:{self.name}"
    def __repr__(self):
        return f"Item(name={self.name!r})"

it = Item("ノート")
name = "ボールペン"
s = "こんにちは\n"
print(f"{it}")
print(f"{it!s}")
print(f"{it!r}")
print(f"{'café'!a}")
print(f"{s!r}")
print(f"{name!r:>12}|")

商品:ノート
商品:ノート
Item(name='ノート')
'caf\xe9'
'こんにちは\n'
     'ボールペン'|

変換フラグは書式指定より先に書きます（{name!r:>12}）。

幅や精度を変数で指定する（ネスト）

書式の中に {} を入れると、幅・精度・寄せを変数で変えられます。

v = 3.14159265
w, p, a, fmt = 10, 3, "^", ".2f"
print(f"{v:{w}.{p}f}|")
print(f"{v:{a}{w}.{p}}|")
print(f"{v:{fmt}}")
print(f"{v:>{w+2}.{p}f}|")

     3.142|
   3.14   |
3.14
       3.142|

表の列幅をデータの最大長に合わせたいときは、w = max(len(x) for x in names) を求めてから f"{x:<{w}}" と書けます。

辞書・属性・インデックスにアクセスする

order = {"id": 101, "item": "ノート", "qty": 3}
items = ["A", "B", "C"]
print(f"{order['item']} x {order['qty']}")
print(f"{items[0]}, {items[-1]}")
print("注文{0[id]}: {0[item]}".format(order))

ノート x 3
A, C
注文101: ノート

Python 3.11以前では、外側と違う引用符（" の中なら '）で辞書のキーを書きます。 3.12以降は同じ引用符も使えます（後述）。str.format() ではキーをクォートせず {0[item]} と書く点が違います。

複数行のf-string

name, qty, unit = "ボールペン", 3, 120
msg = (f"品名: {name}\n"
       f"数量: {qty:>4}\n"
       f"金額: {qty*unit:>6,}円")
print(msg)

html = f"""
<li>{name}</li>
<li>{qty*unit:,}円</li>
""".strip()
print(html)

品名: ボールペン
数量:    3
金額:    360円
<li>ボールペン</li>
<li>360円</li>

かっこで囲んで並べたf-stringは自動で連結されます。 三重引用符の f"""...""" はテンプレートのように書けます。

format()・str.format()・% 演算子との対応表

書式指定ミニ言語は f-string・format()・str.format() で共通です。 % 演算子は別の書き方です。v = 1234567.891 で実行しました。

使い分けの目安：その場の変数を埋め込むなら f-string、書式を先に定義して後から値を入れる（テンプレートを設定ファイルに置く等）なら str.format()、logging のメッセージは % 形式（logger.info("件数: %d", n)）が標準です。

Decimal の書式指定と丸め

Decimal も同じ書式指定が使えます。 ただし丸め方が float と違います。

from decimal import Decimal, ROUND_HALF_UP

print(f"{Decimal('1234.5'):,.2f}")
print(f"{Decimal('0.125'):.2f}", f"{Decimal('0.135'):.2f}")
print(f"{2.675:.2f}", f"{Decimal('2.675'):.2f}")
print(f"{Decimal('1E+3'):f}", f"{Decimal('0.1234'):%}")
print(Decimal("2.675").quantize(Decimal("0.01"), rounding=ROUND_HALF_UP))
print(f"{2.5:.0f}", f"{3.5:.0f}")

1,234.50
0.12 0.14
2.67 2.68
1000 12.34%
2.68
2 4

金額の四捨五入を確実にしたいときは、Decimal と quantize(..., rounding=ROUND_HALF_UP) で丸めてから f-string で表示します。

全角文字で幅がずれる問題と対処

f-string の幅は「文字数」で数えるため、全角文字が入ると表示がずれます。 実行結果です。

rows = [("ノート", 120), ("Pen", 80), ("消しゴムA", 60)]
for name, price in rows:
    print(f"{name:<10}|{price:>5}")

ノート       |  120
Pen       |   80
消しゴムA     |   60

ノート は3文字なので7文字の空白が足されますが、全角は半角2文字分の幅で表示されるため右にずれます。unicodedata.east_asian_width() で表示幅を数える関数を作ると揃います。

import unicodedata


def text_width(s: str) -> int:
    """全角（F/W）を2、それ以外を1として数えた表示幅"""
    return sum(2 if unicodedata.east_asian_width(c) in "FW" else 1 for c in s)


def pad(s: str, width: int, align: str = "<", fill: str = " ") -> str:
    """表示幅で左・右・中央寄せする"""
    space = max(width - text_width(s), 0)
    if align == "<":
        return s + fill * space
    if align == ">":
        return fill * space + s
    left = space // 2
    return fill * left + s + fill * (space - left)


rows = [("ノート", 120), ("Pen", 80), ("消しゴムA", 60)]
for name, price in rows:
    print(f"{pad(name, 10)}|{price:>5}")
print(f"{pad('中央', 10, '^', '*')}|")

ノート    |  120
Pen       |   80
消しゴムA |   60
***中央***|

A（曖昧）の文字は環境によって幅1にも2にもなります。 日本語環境の端末で ① などがずれる場合は、判定に "FWA" を使うと合わせられます。外部ライブラリの wcwidth を使う方法もあります。

Python 3.12の変更（PEP 701）を3.11と比較

Python 3.12 から、f-string の {} の中に「同じ引用符」「バックスラッシュ」「コメント」「改行」を書けるようになりました。 同じファイルを Python 3.11.15 と 3.12.3 で実行した結果です。

3.12で動いたコメント入りのコードです。

qty, unit = 3, 120
total = f"合計: {
    qty * unit  # 数量 × 単価
:,}円"
print(total)

合計: 360円

3.11以前でも動かす必要があるコードでは、次のように書き換えます。

Python 3.14の新機能

小数部にも桁区切り（3.14）

Python 3.14 から、精度の後ろにも , や _ を書けるようになり、小数部を3桁ごとに区切れます。 Python 3.14.7 と 3.13.7 で実行した結果です。

print(f"{1234567.891011:,.6_f}")
print(f"{1234567.891011:_.6,f}")
print(f"{0.123456789:.9_f}")

# Python 3.14.7
1,234,567.891_011
1_234_567.891,011
0.123_456_789

# Python 3.13.7
ValueError: Invalid format specifier ',.6_f' for object of type 'float'

t-string（テンプレート文字列、PEP 750）

t-string は t"..." と書き、文字列ではなく Template オブジェクトを返す新しいリテラルです。 埋め込む値と固定の文字列を分けて受け取れるので、HTMLのエスケープやSQLのパラメータ化などを「埋め込む前に」処理できます。Python 3.14.7 で実行しました。

import html
from string.templatelib import Interpolation, Template

name = "<b>ノート</b>"
qty = 3
t = t"商品: {name} 数量: {qty:>3}"
print(type(t))
print(t.strings)
print(t.values)
for part in t:
    print(repr(part))


def render_html(template: Template) -> str:
    out = []
    for part in template:
        if isinstance(part, Interpolation):
            value = format(part.value, part.format_spec)
            out.append(html.escape(value))
        else:
            out.append(part)
    return "".join(out)


print(render_html(t))
print(f"商品: {name} 数量: {qty:>3}")

<class 'string.templatelib.Template'>
('商品: ', ' 数量: ', '')
('<b>ノート</b>', 3)
'商品: '
Interpolation('<b>ノート</b>', 'name', None, '')
' 数量: '
Interpolation(3, 'qty', None, '>3')
商品: &lt;b&gt;ノート&lt;/b&gt; 数量:   3
商品: <b>ノート</b> 数量:   3

• Interpolation には値・式のテキスト・変換フラグ・書式指定（'>3'）が入っていて、書式の適用は受け取った側が行います（上の例では format(part.value, part.format_spec)）。
• str(t) は結合した文字列にはならず、Template(strings=(...), interpolations=(...)) という表示になりました。文字列が欲しい場面では今までどおり f-string を使います。
• Python 3.13 で同じコードを実行すると、t"..." の行で SyntaxError: invalid syntax になります。

よくあるエラーと直し方

実際に実行したエラーメッセージです。

None やリストに幅指定をすると TypeError になります。 データに None が混ざる列を表示するときは !s を付けるのが手軽です。

よくある質問

Q. f-string と format() はどちらを使えばよいですか？ A. 変数をその場で埋め込むなら f-string が短く読みやすいです。書式文字列を設定ファイルや定数として先に用意し、後から値を入れる場合は str.format() が向いています。書式指定ミニ言語はどちらも同じなので、この記事の表はそのまま使えます。

Q. 小数点以下の不要な0を消すには？ A. f"{12.0:g}" → '12' のように g を使います。ただし g は有効数字6桁で大きな数を指数表記にするため、f"{1234567.0:g}" は '1.23457e+06' になります。桁数が大きい値では f"{v:.2f}".rstrip("0").rstrip(".") のように後処理する方法もあります。

Q. 波かっこ {} を文字として出したいときは？ A. {{ と }} のように2つ重ねます。f"{{{name}}}" は '{ボールペン}' になります。

まとめ

• 書式は「埋め文字・寄せ・符号・z・#・0・幅・区切り・.精度・型」の順に、必要なものだけ書きます。
• 桁区切りは ,、ゼロ埋めは 05、小数2桁は .2f、パーセントは .1% が基本の4つです。
• .3 は有効数字、.3f は小数点以下の桁数で意味が違います。
• 日付は f"{dt:%Y-%m-%d}"、0埋めなしは {dt.month} のように属性を使うとOSを問いません。
• {変数=} でデバッグ表示、!r で repr 表示ができます。
• 全角文字は unicodedata.east_asian_width() で幅を数えて揃えます。
• 3.12で同じ引用符・バックスラッシュ・コメントが使えるようになり、3.14で小数部の区切りと t-string が加わりました。

株式会社RJCでは、f-stringのような日々のコードを読みやすくする書き方を、プロジェクトの中で仲間と教え合っています。こうした知識を共有しながら、日々技術を磨いています。

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。