# 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.

---

Marca un valor dinámico como una variable no traducible para que se preserve entre idiomas. Úsalo 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")
```