# General Translation Python SDKs: declare_var
URL: https://generaltranslation.com/es/docs/python/reference/functions/declare-var.mdx
---

title: declare_var
description: Marca un valor dinámico como una variable no traducible en General Translation para Python. Referencia de la API de declare_var.

---

Una variable no traducible es un valor dinámico que permanece sin cambios entre idiomas. Usa `declare_var` para valores que solo se conocen en tiempo de ejecución, como nombres de usuario, correos electrónicos y cantidades, incrustados dentro de una llamada a [`t`](/docs/python/reference/functions/t).

## Descripción general [#overview]

Llama a `declare_var` con un valor y un `name` opcional solo por palabra clave. Devuelve una construcción ICU `{_gt_, select, ...}` que inserta el valor como marcador de variable de General Translation.

```python
from gt_flask import declare_var  # o bien: from gt_fastapi import declare_var, o bien: from gt_i18n import declare_var

t(f"Signed in as {declare_var(email, name='email')}")
```

Firma:

```python
declare_var(
    variable: str | int | float | bool | None,
    *,
    name: str | None = None,
) -> str
```

Se reexporta desde `generaltranslation.static` por `gt_i18n` y los paquetes del framework.

## Cómo funciona [#how-it-works]

* **Formateo de valores.** `None` se convierte en una cadena vacía, `bool` se convierte en `"true"`/`"false"` y los demás valores se convierten en cadenas; el resultado se sanitiza.
* **Construcción del marcador.** Devuelve `{_gt_, select, other {value}}`, opcionalmente con una cláusula `_gt_var_name {name}` si se proporciona `name`.
* **Tiempo de ejecución vs. tiempo de compilación.** Úsalo para valores de tiempo de ejecución; para un valor con un conjunto finito de posibles resultados en tiempo de compilación, usa [`derive`](/docs/python/reference/functions/derive). Recupera los valores incrustados con [`decode_vars`](/docs/python/reference/functions/decode-vars).

## Parámetros [#parameters]

| Parámetro               | Descripción                                                                        | Tipo                                  | Opcional | Predeterminado |
| ----------------------- | ---------------------------------------------------------------------------------- | ------------------------------------- | -------- | -------------- |
| [`variable`](#variable) | El valor que se insertará como una variable no traducible.                         | `str \| int \| float \| bool \| None` | No       | —              |
| [`name`](#name)         | Nombre de variable legible para humanos solo por palabra clave. | `str`                                 | Sí       | `None`         |

### `variable` [#variable]

**Tipo** `str | int | float | bool | None` · **Obligatorio**

El valor que se va a insertar. `None` se muestra como una cadena vacía; los valores booleanos se muestran en minúsculas.

### `name` [#name]

**Tipo** `str` · **Opcional** · **Predeterminado** `None`

Una etiqueta legible para humanos solo por palabra clave para la variable, que se añade como una cláusula `_gt_var_name` cuando se proporciona.

## Devuelve [#returns]

**Tipo** `str`

Una construcción de ICU `{_gt_, select, ...}` que encapsula el valor como marcador de variable.

## Ejemplo [#example]

```python
from gt_flask import t, declare_var

# Preservar un valor de tiempo de ejecución dentro de un f-string traducido
message = t(f"{declare_var(name, name='name')} goes home")
```