f-string in Python: formattazione, espressioni e formato dei numeri

Il formato che userai davvero

Le f-string sono il modo standard con cui il codice Python moderno inserisce valori nel testo. Metti una f davanti alla virgoletta di apertura, e tutto ciò che sta dentro {...} diventa un'espressione viva:

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}.")

Tre cose da notare. Il prefisso f trasforma l'intero letterale in un modello. Le graffe sono i punti di sostituzione. E l'espressione tra le graffe viene valutata nel momento in cui viene eseguito print, non quando è stata scritta la stringa.

Scriverai f-string molto più spesso di qualsiasi altro stile di formattazione. Sono più brevi di "Hello, " + name + ".", più chiare di "Hello, %s." % name e più flessibili di .format().

Dentro ci va tutto ciò che si può valutare

Le graffe non sono limitate ai nomi di variabile. Qualsiasi espressione Python va bene:

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")

Chiamate di metodi, indici, aritmetica, espressioni condizionali: va tutto bene. L'unica regola: tieni corto quello che sta tra le graffe. Se stai scrivendo un calcolo di tre righe dentro un segnaposto, calcolalo prima in una variabile con un nome e inserisci quella.

Formattare i numeri

I due punti dopo l'espressione aprono una specifica di formato, un mini linguaggio per controllare come viene mostrato il valore:

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}")

Una guida veloce a cosa fa ogni pezzo:

• .2f: float, due cifre dopo il punto. Arrotonda per la visualizzazione.
• ,: virgola come separatore delle migliaia. Funziona con int e float.
• .1%: moltiplica per 100 e aggiunge %. Ottimo per rapporti e tassi.
• .2e: notazione scientifica con due cifre decimali.

Puoi combinarli. f"{total:,.2f}" dà "1,234.57".

Riempimento, larghezza e allineamento

Per allineare colonne di output:

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

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

<10 significa "allinea all'inizio, riempiendo fino ad almeno 10 caratteri". >5 significa "allinea alla fine, riempiendo fino a 5". Puoi anche usare ^ per centrare.

Per riempire con qualcosa di diverso dagli spazi, metti il carattere di riempimento prima del simbolo di allineamento:

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

Formattare le date

La stessa sintassi {value:spec} funziona con gli oggetti 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}")

La specifica dopo i due punti è una stringa di formato di strftime. Qui funziona ogni codice % disponibile per strftime: li vedremo nel dettaglio nella pagina su datetime.

Il trucco dell'= per il debug

Una delle funzionalità di nicchia più utili: metti = dopo l'espressione e Python stampa sia il testo dell'espressione sia il suo valore:

count = 7
price = 19.99

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

Ottieni count=7, price=19.99, count * price=139.93. È un intero print("count =", count) in tre caratteri. Vale la pena ricordarlo la prossima volta che fai debug e vuoi stampare qualche valore.

Scrivere graffe letterali

Se ti serve una { o una } letterale nell'output, raddoppiala:

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

Le graffe singole aprono un'espressione; {{ e }} diventano { e } nell'output.

f-string su più righe

Le f-string funzionano bene con le virgolette triple, cosa utile quando costruisci piccoli modelli al volo:

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

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

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

print(template)

Puoi anche spezzare una f-string lunga in più letterali stringa adiacenti: Python li concatena in automatico:

name = "Rosa"
count = 3

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

print(message)

Quando saltano ancora fuori i vecchi stili

Nel codice esistente incontrerai due stili di formattazione più vecchi:

name = "Rosa"
age = 30

# Formattazione con %: ereditata dal printf del C.
print("Hello, %s. You are %d." % (name, age))

# str.format(): lo standard dell'epoca di Python 2.
print("Hello, {}. You are {}.".format(name, age))

# f-string: quello che scriverai tu.
print(f"Hello, {name}. You are {age}.")

Tutti e tre producono lo stesso output. Nove volte su dieci le f-string vincono in leggibilità. Ricorri a .format() quando devi costruire un modello una volta e applicarlo molte volte; usa % solo quando mantieni codice vecchio che lo usa già.

A cosa non servono

Due situazioni richiedono uno strumento diverso.

Costruire query SQL. Non inserire mai l'input dell'utente in una stringa SQL con una f-string. Usa le query parametrizzate della tua libreria per il database. Una f-string in quel punto è proprio il modo in cui nasce una SQL injection.

Costruire testi dell'interfaccia da tradurre. Se la tua app supporta più lingue, ti serve un modello che gli strumenti di traduzione esterni possano raccogliere: di solito _(...) di gettext o un helper specifico del framework. Una f-string incorpora la struttura nel codice sorgente, il che rende la traduzione molto più difficile.

Per tutto il resto (log, output nella console, costruzione di URL, stringhe di configurazione, formattazione di numeri da mostrare) le f-string sono la risposta giusta.

Prossimo argomento: numeri e booleani

Le f-string lavorano moltissimo per formattare numeri, quindi conviene conoscere un po' più a fondo i tipi numerici. Ecco il prossimo argomento.