# gt-next: General Translation Next.js SDK: getGT
URL: https://generaltranslation.com/es/docs/next/api/strings/get-gt.mdx
---
title: getGT
description: Referencia de la API para la función getGT() de traducción de cadenas
---

## Descripción general

La función `getGT` es una función asíncrona para traducir cadenas durante el tiempo de construcción.

```jsx
const gt = await getGT();

<p>{  gt('This text will be translated')  }</p>;
```

<Callout>
  **Traducción en tiempo de construcción:**
  Las traducciones de `getGT` se realizan en tiempo de construcción, antes de que se despliegue tu aplicación.
  Aunque puedes pasar variables a la cadena traducida, solo puedes traducir contenido que se conozca en tiempo de construcción.
</Callout>


## Referencia

### Parámetros

Ninguno

### Devuelve

Una promesa que devuelve una función de callback, `gt`, que traduce el contenido proporcionado.

```jsx
Promise<(content: string, options?: InlineTranslationOptions) => string>
```

| Nombre     | Tipo                                                                          | Descripción                                                         |
| ---------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| `content`  | `string`                                                                      | El contenido de la cadena que se va a traducir.                     |
| `options?` | [`InlineTranslationOptions`](/docs/next/api/types/inline-translation-options) | Opciones de traducción para personalizar el comportamiento de `gt`. |

***


## Funcionamiento

### Producción

Durante el proceso de CD, cualquier contenido dentro de una función `gt` se traducirá antes de que tu aplicación se despliegue.
Esto garantiza tiempos de carga rápidos para todas las configuraciones regionales, pero solo puede traducir contenido que se conozca en tiempo de construcción.

Una vez generadas, las traducciones se almacenan (1) en la CDN o (2) en el resultado de compilación de tu aplicación, según tu configuración.
A partir de ahí, el contenido traducido se sirve a tus usuarios.
Si no se encuentra una traducción, se usará el contenido original.

Asegúrate de seguir la [guía de despliegue aquí](/docs/next/tutorials/quickdeploy).

### Desarrollo

Durante el desarrollo, la función `gt` traducirá el contenido bajo demanda.
Esto resulta útil para prototipar cómo se verá tu aplicación en distintos idiomas.
Recuerda añadir una clave de API de desarrollo a tu entorno para habilitar este comportamiento.

Verás un retraso durante la traducción bajo demanda en desarrollo.
Esto no ocurrirá en las compilaciones de producción, a menos que el contenido se esté traduciendo explícitamente bajo demanda,
es decir, con [`tx`](/docs/next/api/strings/tx) o [`<Tx>`](/docs/next/api/components/tx).

***

## Ejemplo

### Uso básico

Puedes usar `getGT` para traducir cadenas de texto.

```javascript copy
import { getGT } from 'gt-next/server';

export default async function TranslateGreeting() {
  const gt = await getGT();

  return (
    <p>
      {gt('Hello, Alice!')}
    </p>
  );
}
```

Nota: &quot;Alice&quot; se traducirá al idioma que prefiera el usuario.


### Uso de variables [#variables]

Puedes pasar variables a las traducciones del diccionario.

```javascript copy
import { getGT } from 'gt-next/server';

export default async function TranslateGreeting() {
  const gt = await getGT();

  return (
    <p>
      {gt('Hello, {name}!', { name: 'Alice' })}
    </p>
  );
}
```

Nota: &quot;Alice&quot; no se traducirá al idioma preferido del usuario, ya que es una variable.


### Traducir los metadatos de la página [#metadata]

Usa `getGT` dentro de `generateMetadata` de Next.js para traducir los títulos, las descripciones y las etiquetas de Open Graph de la página.

```javascript copy
import { getGT } from 'gt-next/server';
import { Metadata } from 'next';

export async function generateMetadata(): Promise<Metadata> {
  const gt = await getGT();
  return {
    title: gt('My App'),
    description: gt('A fast, modern web application'),
    openGraph: {
      title: gt('My App'),
      description: gt('A fast, modern web application'),
    },
  };
}
```


### Uso del formato de mensajes ICU

`gt-next` admite el formato de mensajes ICU, que también te permite formatear las variables.

```javascript copy
import { getGT } from 'gt-next/server';

export default async function TranslateGreeting() {
  const gt = await getGT();
  return (
    <p>
      {gt('There are {count, plural, =0 {no items} =1 {one item} other {{count} items}} in the cart', { count: 10 })}
    </p>
  );
}
```

<Callout>
  El formato de mensajes ICU es una forma potente de dar formato a las variables.
  Para más información, consulta la [documentación del formato de mensajes ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/).
</Callout>

***


## Notas

* La función `getGT` es una función del lado del servidor que traduce cadenas.
* La traducción de cadenas con `getGT` ocurre antes del runtime, durante el proceso de compilación (salvo en desarrollo).

## Próximos pasos

* Consulta [`useGT`](/docs/next/api/strings/use-gt) para traducir cadenas del lado del cliente en tiempo de construcción.
* Para las traducciones en runtime, consulta [`tx`](/docs/next/api/strings/tx) y [`<Tx>`](/docs/next/api/components/tx).