# 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 la API de la función de traducción getTranslations del lado del servidor
---

## Resumen

`getTranslations` se usa para obtener cadenas traducidas del [diccionario de traducción](/docs/next/guides/dictionaries) en componentes del lado del servidor.

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

`getTranslations` admite:

* La traducción de cadenas y contenido JSX.
  * Inserción de variables y lógica condicional dentro de las traducciones.
  * Prefijo de id opcional.

Para las 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 para su traducción.
  Esto es diferente de usar el [componente `<T>`](/docs/next/guides/t) para la traducción.
  Si solo te interesa usar componentes `<T>` para la traducción, este documento no es relevante.
</Callout>


## Referencia

### Props

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

### Descripción

| Propiedad | Descripción                                                                                                                                  |
| --------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`      | Un prefijo opcional que se añade al principio de todas las claves de traducción. Es útil para trabajar con valores anidados del diccionario. |

### Devuelve

Una promesa que devuelve 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) => React.ReactNode>
```

| 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 traducirán.

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

Cuando queremos acceder a estas entradas (del lado del 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')} // Hola, 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 a 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 recuperar 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 tienen 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 del lado del servidor.

## Próximos pasos

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