f-stringi w Pythonie: formatowanie, wyrażenia i specyfikatory liczb

Format, którego naprawdę będziesz używać

f-stringi to domyślny sposób, w jaki współczesny kod Pythona wstawia wartości do tekstu. Postaw f przed cudzysłowem otwierającym, a wszystko wewnątrz {...} stanie się żywym wyrażeniem:

name = "Rosa"
hour = 9

print(f"Good morning, {name}.")
print(f"It's {hour} o'clock.")
print(f"In two hours it'll be {hour + 2}.")

Zwróć uwagę na trzy rzeczy. Prefiks f zamienia cały literał w szablon. Nawiasy klamrowe to miejsca podstawienia. A wyrażenie w nawiasach jest obliczane w chwili, gdy wykonuje się print, a nie wtedy, gdy napis powstał w kodzie.

f-stringi będziesz pisać dużo częściej niż jakikolwiek inny styl formatowania. Są krótsze niż "Hello, " + name + ".", czytelniejsze niż "Hello, %s." % name i bardziej elastyczne niż .format().

W środku może być wszystko, co daje wartość

Nawiasy klamrowe nie są ograniczone do nazw zmiennych. Nadaje się każde wyrażenie Pythona:

items = ["apple", "banana", "cherry"]
price = 19.95
tax = 0.08

print(f"You have {len(items)} items.")
print(f"The first is {items[0].upper()}.")
print(f"Total with tax: {price * (1 + tax)}")
print(f"Short line" if len(items) < 5 else f"Long line with {len(items)} items")

Wywołania metod, indeksowanie, arytmetyka, wyrażenia warunkowe: wszystko w porządku. Jedna zasada: to, co jest między nawiasami, ma być krótkie. Jeśli w miejscu podstawienia piszesz trzylinijkowe obliczenie, najpierw zapisz wynik w nazwanej zmiennej i wstaw tę nazwę.

Formatowanie liczb

Dwukropek po wyrażeniu otwiera specyfikację formatu (format spec), czyli minijęzyk określający, jak wartość ma być wyświetlona:

total = 1234.5678

print(f"Two decimals: {total:.2f}")
print(f"Zero decimals: {total:.0f}")
print(f"Comma-separated: {total:,.2f}")
print(f"As percent: {0.875:.1%}")
print(f"Scientific:  {total:.2e}")

Krótki przewodnik po poszczególnych elementach:

• .2f: float, dwie cyfry po kropce. Zaokrągla przy wyświetlaniu.
• ,: przecinek jako separator tysięcy. Działa dla int i float.
• .1%: mnoży przez 100 i dopisuje %. Świetne do proporcji i wskaźników.
• .2e: notacja naukowa z dwiema cyframi po przecinku.

Możesz je łączyć. f"{total:,.2f}" daje "1,234.57".

Dopełnianie, szerokość i wyrównanie

Do wyrównywania kolumn wyjścia:

rows = [("apple", 30), ("banana", 120), ("cherry", 6)]

for name, count in rows:
    print(f"{name:<10} {count:>5}")

<10 oznacza "wyrównaj do początku i dopełnij do co najmniej 10 znaków". >5 oznacza "wyrównaj do końca i dopełnij do 5". Możesz też użyć ^, by wyśrodkować.

Aby dopełniać czymś innym niż spacje, postaw znak wypełnienia przed flagą wyrównania:

print(f"{42:*>6}")     # ****42
print(f"{'title':-^20}")   # -------title--------

Formatowanie dat

Ta sama składnia {value:spec} działa dla obiektów datetime:

from datetime import datetime

now = datetime(2026, 4, 20, 14, 30)

print(f"{now:%Y-%m-%d}")
print(f"{now:%A, %B %d}")
print(f"{now:%I:%M %p}")

Specyfikacja po dwukropku to napis formatu strftime. Działa tu każdy kod % dostępny w strftime, a szczegółowo omawia je strona o datetime.

Sztuczka z = do debugowania

Jedna z najbardziej przydatnych mniej znanych funkcji: postaw = po wyrażeniu, a Python wypisze zarówno kod wyrażenia, jak i jego wartość:

count = 7
price = 19.99

print(f"{count=}")
print(f"{price=}")
print(f"{count * price=:.2f}")

Dostajesz count=7, price=19.99, count * price=139.93. To pełne print("count =", count) w trzech znakach. Warto o tym pamiętać, gdy następnym razem przy debugowaniu zechcesz wypisać kilka wartości.

Escapowanie nawiasów klamrowych

Jeśli potrzebujesz w wyjściu dosłownego { albo }, podwój go:

style = "dark"
print(f"CSS: {{ color: {style}; }}")

Pojedyncze nawiasy otwierają wyrażenie, a {{ i }} oznaczają w wyjściu { i }.

Wielolinijkowe f-stringi

f-stringi dobrze współpracują z potrójnymi cudzysłowami, co pomaga przy budowaniu małych szablonów bezpośrednio w kodzie:

name = "Rosa"
role = "editor"
joined = 2023

template = f"""
Welcome, {name}!

Role:   {role}
Joined: {joined}
"""

print(template)

Długi f-string możesz też podzielić na kilka sąsiednich literałów, a Python automatycznie je połączy:

name = "Rosa"
count = 3

message = (
    f"Hi {name},\n"
    f"you have {count} new messages.\n"
    f"Reply to the oldest first."
)

print(message)

Kiedy nadal spotyka się starsze style

W istniejącym kodzie trafisz na dwa starsze style formatowania:

name = "Rosa"
age = 30

# formatowanie przez %, odziedziczone po printf z C.
print("Hello, %s. You are %d." % (name, age))

# str.format(), standard z czasów Pythona 2.
print("Hello, {}. You are {}.".format(name, age))

# f-string, czyli to, co będziesz pisać.
print(f"Hello, {name}. You are {age}.")

Wszystkie trzy dają to samo wyjście. f-stringi wygrywają czytelnością w dziewięciu przypadkach na dziesięć. Po .format() sięgaj, gdy trzeba zbudować szablon raz i stosować go wiele razy, a % używaj tylko przy utrzymywaniu starszego kodu, który już z niego korzysta.

Do czego się nie nadają

W dwóch sytuacjach potrzebne jest inne narzędzie.

Budowanie zapytań SQL. Nigdy nie wstawiaj danych od użytkownika do napisu SQL przez f-string. Używaj zapytań parametryzowanych z biblioteki do bazy danych. f-string w tym miejscu to prosta droga do SQL injection.

Budowanie tłumaczonych tekstów interfejsu. Jeśli aplikacja obsługuje wiele języków, potrzebujesz szablonu, który wychwycą zewnętrzne narzędzia do tłumaczeń, zwykle _(...) z gettext albo pomocnika z frameworka. f-string zaszywa strukturę w kodzie źródłowym, co bardzo utrudnia tłumaczenie.

We wszystkich innych przypadkach (logi, wyjście w konsoli, budowanie adresów URL, składanie napisów konfiguracyjnych, formatowanie liczb do wyświetlenia) f-stringi to właściwa odpowiedź.

Dalej: liczby i wartości logiczne

f-stringi bardzo często formatują liczby, więc warto poznać typy liczbowe trochę głębiej. O tym jest następna strona.