# python: t
URL: https://generaltranslation.com/es/docs/python/api/t.mdx
---
title: t
description: Referencia de la API de la función de traducción t
---

## Resumen

La función `t` traduce e interpola una cadena en ICU MessageFormat.
Busca la configuración regional actual, encuentra una traducción en caché por hash e interpola variables.
Si no encuentra ninguna traducción, usa la cadena de origen.

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

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


## Referencia

### Parámetros

<TypeTable
  type={{
  "message": {
    type: 'str',
    description: 'La cadena de origen en ICU MessageFormat.',
  },
  "**kwargs": {
    type: 'object',
    description: 'Variables de interpolación y opciones de GT.',
  },
}}
/>

### Opciones de GT (pasadas mediante `**kwargs`)

| Opción       | Tipo  | Descripción                                                                 |
| ------------ | ----- | --------------------------------------------------------------------------- |
| `_context`   | `str` | Contexto adicional para desambiguar traducciones con el mismo texto fuente. |
| `_id`        | `str` | Identificador personalizado para la entrada de traducción.                  |
| `_max_chars` | `int` | Longitud máxima de caracteres de la salida.                                 |

### Devuelve

`str` — la cadena traducida e interpolada.

***

## Ejemplos

### Traducción básica

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


### Con variables

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


### Con contexto

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


### Con f-strings y `declare_var`

Las f-strings de Python funcionan de forma natural con `t`; solo tienes que envolver tus variables con [`declare_var`](/docs/python/api/declare-var):

```python
from gt_flask import t, declare_var

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

# Después de i18n — solo envuelve con t() y declare_var():
message = t(f"{declare_var(name, name='name')} goes home")
```


### Con límite de caracteres

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

***


## Notas

* `t` requiere que se llame primero a [`initialize_gt`](/docs/python/api/initialize-gt).
* Si la configuración regional actual coincide con la configuración regional predeterminada, no se realiza ninguna búsqueda de traducción; solo se interpolan variables.
* Las variables se interpolan mediante la sintaxis de ICU MessageFormat (p. ej., `{name}`, `{count, plural, one {# item} other {# items}}`).