# python: t
URL: https://generaltranslation.com/it/docs/python/api/t.mdx
---
title: t
description: Riferimento API della funzione di traduzione t
---

## Panoramica

La funzione `t` traduce e interpola una stringa in formato ICU MessageFormat.
Recupera l'impostazione regionale corrente, trova una traduzione memorizzata nella cache tramite hash e interpola le variabili.
Se non trova alcuna traduzione, usa la stringa sorgente come fallback.

```python
from gt_flask import t  # oppure from gt_fastapi import t

message = t("Hello, {name}!", name="World")
```


## Riferimento

### Parametri

<TypeTable
  type={{
  "message": {
    type: 'str',
    description: 'La stringa sorgente in formato ICU MessageFormat.',
  },
  "**kwargs": {
    type: 'object',
    description: 'Variabili di interpolazione e opzioni GT.',
  },
}}
/>

### Opzioni di GT (passate tramite `**kwargs`)

| Opzione      | Tipo  | Descrizione                                                                    |
| ------------ | ----- | ------------------------------------------------------------------------------ |
| `_context`   | `str` | Contesto aggiuntivo per distinguere traduzioni con lo stesso testo di origine. |
| `_id`        | `str` | Identificatore personalizzato per la voce di traduzione.                       |
| `_max_chars` | `int` | Numero massimo di caratteri dell&#39;output.                                   |

### Restituisce

`str` — la stringa tradotta e con valori interpolati.

***

## Esempi

### Traduzione semplice

```python
t("Hello, world!")
```


### Con variabili

```python
t("Hello, {name}!", name="Alice")
```


### Con contesto

```python
t("Bank", _context="financial institution")
t("Bank", _context="river bank")
```

### Con le f-string e `declare_var`

Le f-string di Python funzionano naturalmente con `t`: ti basta racchiudere le variabili in [`declare_var`](/docs/python/api/declare-var):

```python
from gt_flask import t, declare_var

# Prima dell'i18n:
message = f"{name} goes home"

# Dopo l'i18n — basta racchiudere con t() e declare_var():
message = t(f"{declare_var(name, name='name')} goes home")
```


### Con un limite di caratteri

```python
t("This is a very long message that might need truncation", _max_chars=20)
```

***


## Note

* `t` richiede che [`initialize_gt`](/docs/python/api/initialize-gt) venga chiamato prima.
* Se l&#39;impostazione regionale corrente coincide con quella predefinita, non viene eseguita alcuna ricerca di traduzione — viene effettuata solo l&#39;interpolazione.
* Le variabili vengono interpolate usando la sintassi ICU MessageFormat (ad esempio, `{name}`, `{count, plural, one {# item} other {# items}}`).