# gt-next: General Translation Next.js SDK: getTranslations
URL: https://generaltranslation.com/es/docs/next/api/dictionary/get-translations.mdx
---
title: getTranslations
description: Referencia de API de la función de traducción getTranslations del servidor
---

## Resumen

`getTranslations` se usa para obtener traducciones de cadenas del [diccionario de traducciones](/docs/next/guides/dictionaries) para componentes del servidor.

```jsx
const d = await getTranslations(); // Obtiene la función de traducción
d('greeting.hello'); // pasa el id para obtener una traducción
```

`getTranslations` admite:

* Traducción de contenido de cadena y JSX.
  * Inserción de variables y lógica condicional dentro de las traducciones.
  * Prefijo de ID opcional.

Para traducciones del lado del cliente, consulta [`useTranslations`](/docs/next/api/dictionary/use-translations).

<Callout>
  `getTranslations` y `useTranslations` usan un [diccionario](/docs/next/guides/dictionaries) para almacenar todo el contenido traducible.
  Esto es distinto de usar el [componente `<T>`](/docs/next/guides/t) para traducir.
  Si te interesa usar únicamente componentes `<T>` para traducir, este documento no es relevante.
</Callout>

## Referencia

### Props

<TypeTable
  type={{
  "id?": {
      type: 'string',
      optional: true,
      default: 'undefined',
  },
}}
/>

### Descripción

| Prop | Descripción                                                                                                                        |
| ---- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `id` | Prefijo opcional que se antepone a todas las claves de traducción. Resulta útil para trabajar con valores de diccionario anidados. |

### Devuelve

Una promesa de una función de traducción `d` que, dado un id, devuelve la versión traducida de la entrada correspondiente

```jsx
Promise<(id: string, options?: DictionaryTranslationOptions) => string>
```

| Nombre     | Tipo                                                                                  | Descripción                                                        |
| ---------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| `id`       | `string`                                                                              | El id de la entrada que se traducirá                               |
| `options?` | [`DictionaryTranslationOptions`](/docs/next/api/types/dictionary-translation-options) | Opciones de traducción para personalizar el comportamiento de `d`. |

***

## Ejemplos

### Uso básico del diccionario

Todas las entradas de tu diccionario se traducen.

```jsx title="dictionary.jsx" copy
const dictionary = {
  greeting: <>Hello, Alice!</>, // [!code highlight]
};
export default dictionary;
```

Cuando queremos acceder a estas entradas (en el servidor), llamamos a `getTranslations`.
Esto devuelve una función que acepta la clave de una traducción del diccionario.

```jsx title="TranslateGreeting.jsx" copy
import { getTranslations } from 'gt-next/server';

export default async function TranslateGreeting() {
  
  const d = await getTranslations(); // [!code highlight]

  return (
    <p>
      {d('greeting')} // Hello, Alice // [!code highlight]
    </p>
  );
}
```


### Uso de variables [#variables]

Para pasar valores, debes (1) asignar un identificador y (2) hacer referencia a ese identificador al llamar a la función `d`.

En este ejemplo, usamos `{}` para pasar variables en las traducciones.
En el diccionario, asignamos el identificador `{userName}`.

```jsx title="dictionary.jsx" copy
// [!code word:userName]
const dictionary = {
  greeting: "¡Hola, {userName}!", // [!code highlight]
};
export default dictionary;
```

```jsx title="TranslateGreeting.jsx" copy
// [!code word:userName]
import { getTranslations } from 'gt-next/server';

export default async function TranslateGreeting() {
  const d = await getTranslations();
  
  // ¡Hola Alice!
  const greetingAlice = d('greeting', { userName: "Alice" }); // [!code highlight]

  return (
    <p>
      {greetingAlice}
    </p>
  );
}
```


### Uso de prefijos

Podemos usar prefijos para obtener solo una parte del diccionario.

```jsx title="dictionary.jsx" copy
const dictionary = {
  prefix1: { // [!code highlight]
    prefix2: { // [!code highlight]
      greeting: "Hello, Bob",
    }
  }
};
export default dictionary;
```

Como añadimos el valor `'prefix1.prefix2'` al método `getTranslations`, todas las claves llevan el prefijo `prefix1.prefix2`:

```jsx title="UserDetails.jsx" copy
import { getTranslations } from 'gt-next/server';

export default function UserDetails() {
  const d = await getTranslations('prefix1.prefix2'); // [!code highlight]
  return (
    <div>
      <p>{d('greeting')}</p> // greeting => prefix1.prefix2.greeting // [!code highlight]
    </div>
  );
}
```

***


## Notas

* La función `getTranslations` te permite acceder a las traducciones del diccionario en el servidor.

## Próximos pasos

* Consulta [`useTranslations`](/docs/next/api/dictionary/use-translations) para conocer el equivalente de `getTranslations` del lado del cliente.