# python: t
URL: https://generaltranslation.com/fr/docs/python/api/t.mdx
---
title: t
description: Référence de l’API de la fonction de traduction t
---

## Vue d’ensemble

La fonction `t` traduit une chaîne au format ICU MessageFormat et y interpole les variables.
Elle détermine le paramètre régional actuel, trouve une traduction mise en cache à partir du hachage et interpole les variables.
Si aucune traduction n’est trouvée, elle revient à la chaîne source.

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

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


## Référence

### Paramètres

<TypeTable
  type={{
  "message": {
    type: 'str',
    description: 'La chaîne source au format ICU MessageFormat.',
  },
  "**kwargs": {
    type: 'object',
    description: 'Variables d’interpolation et options GT.',
  },
}}
/>

### Options de GT (transmises via `**kwargs`)

| Option       | Type  | Description                                                                            |
| ------------ | ----- | -------------------------------------------------------------------------------------- |
| `_context`   | `str` | Contexte supplémentaire pour désambiguïser des traductions ayant le même texte source. |
| `_id`        | `str` | Identifiant personnalisé pour l’entrée de traduction.                                  |
| `_max_chars` | `int` | Nombre maximal de caractères en sortie.                                                |

### Renvoie

`str` — la chaîne traduite avec interpolation.

***

## Exemples

### Traduction simple

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


### Avec variables

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


### Avec un contexte

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


### Avec les f-strings et `declare_var`

Les f-strings Python s’utilisent naturellement avec `t` — il vous suffit d’entourer vos variables avec [`declare_var`](/docs/python/api/declare-var) :

```python
from gt_flask import t, declare_var

# Avant i18n :
message = f"{name} goes home"

# Après i18n — enveloppez simplement avec t() et declare_var() :
message = t(f"{declare_var(name, name='name')} goes home")
```


### Avec une limite de caractères

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

***


## Remarques

* `t` nécessite que [`initialize_gt`](/docs/python/api/initialize-gt) soit appelé au préalable.
* Si le paramètre régional actuel correspond au paramètre régional par défaut, aucune recherche de traduction n’est effectuée ; seule l’interpolation a lieu.
* Les variables sont interpolées à l’aide de la syntaxe ICU MessageFormat (par exemple, `{name}`, `{count, plural, one {# item} other {# items}}`).