# gt-next: General Translation Next.js SDK: getLocale
URL: https://generaltranslation.com/es/docs/next/api/helpers/get-locale.mdx
---
title: getLocale
description: Referencia de la API para el método getLocale del lado del servidor
---

## Descripción general

La función `getLocale` obtiene la configuración regional actual del usuario durante el renderizado del lado del servidor.
La configuración regional se devuelve como un [código de configuración regional](/docs/core/locales) BCP 47, por ejemplo, `'en-US'`.

<Callout>
  `getLocale` es un método del lado del servidor y solo puede usarse en componentes
  del lado del servidor.
</Callout>

Para usarlo del lado del cliente, consulta [`useLocale`](/docs/next/api/helpers/use-locale).

## Referencia

### Devuelve

Una promesa que se resuelve como una cadena que representa la configuración regional actual del usuario, por ejemplo, `'en-US'`.

***

## Comportamiento de respaldo

Cuando se solicita una configuración regional no compatible, se seleccionará una configuración regional de respaldo.

Por ejemplo, si se solicita una configuración regional no compatible,
si (1) el usuario ha configurado varias configuraciones regionales preferidas en su navegador
y (2) una de esas configuraciones regionales es compatible con tu aplicación,
entonces se usará como respaldo la mejor coincidencia de idioma.

Además, si no hay configuraciones regionales de respaldo disponibles,
pero dos configuraciones regionales comparten el mismo idioma (por ejemplo, `en-US` y `en-GB`),
entonces se usará como respaldo la configuración regional compatible que comparta ese mismo idioma.

Si no se cumple ninguna de estas condiciones, se usará la configuración regional predeterminada.

Consulta la documentación de [`gt.config.json`](/docs/next/api/config/gt-config-json) para obtener información sobre cómo configurar las configuraciones regionales compatibles.

***

## Ejemplos

### Uso básico

Obtén la configuración regional del usuario durante el renderizado del lado del servidor.

```javascript title="GetUserLocale.jsx" copy
import { getLocale } from 'gt-next/server';

export default async function GetUserLocale() {
  const locale = await getLocale(); // [!code highlight]
  return <p>User locale: {locale}</p>;
}
```

***


## Notas

* La función `getLocale` es asíncrona y debes usar `await` para obtener la configuración regional.
* Está diseñada específicamente para usarse del lado del servidor. Consulta [`useLocale`](/docs/next/api/helpers/use-locale) para componentes del lado del cliente.
* La configuración regional devuelta cumple con el formato de [código de configuración regional](/docs/core/locales).

## Siguientes pasos

* Aprende a configurar las configuraciones regionales compatibles con [withGTConfig()](/docs/next/api/config/with-gt-config).