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

## Resumen

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) conforme a BCP 47, p. ej., `'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 en una cadena que representa la configuración regional actual del usuario, por ejemplo, `'en-US'`.

***

## Comportamiento de la alternativa

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

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

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

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

Consultar 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 sigue el formato de [código de configuración regional](/docs/core/locales).

## Próximos pasos

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