# General Translation React SDKs (gt-react, gt-next): useLocale
URL: https://generaltranslation.com/es/docs/react/reference/hooks/use-locale.mdx
---

title: useLocale
description: Lee la configuración regional activa con General Translation gt-react. Referencia de la API de useLocale.

---

El hook `useLocale` devuelve la configuración regional actual del usuario desde el contexto de [`<GTProvider>`](/docs/react/reference/components/gt-provider), como un código de configuración regional BCP 47, como `en-US`.

*Disponible en `gt-react`, `gt-next`, `gt-tanstack-start` y `gt-react-native`. Los ejemplos importan desde `gt-react`; en su lugar, importa desde el paquete de tu framework.*

## Descripción general [#overview]

Usa `useLocale` para consultar la configuración regional activa.

```tsx
import { useLocale } from 'gt-react';

export default function CurrentLocale() {
  const locale = useLocale(); // [!code highlight]
  return <p>Current locale: {locale}</p>;
}
```

*Nota: En `gt-react`, llama a `useLocale` dentro de un [`<GTProvider>`](/docs/react/reference/components/gt-provider). En `gt-next`, también funciona en componentes de servidor síncronos.*

## Cómo funciona [#how-it-works]

Cuando se solicita una configuración regional no compatible, se selecciona un contenido alternativo:

* Si el usuario tiene varias configuraciones regionales preferidas configuradas en su navegador y una de ellas es compatible, se usa el idioma compatible más adecuado.
* De lo contrario, si dos configuraciones regionales comparten el mismo idioma (por ejemplo, `en-US` y `en-GB`), se usa la configuración regional compatible que comparte ese idioma.
* Si no se da ninguno de esos casos, se usa la [configuración regional predeterminada](/docs/react/reference/config#default-locale).

## Devuelve [#returns]

**Tipo** `string`

La configuración regional actual del usuario, por ejemplo, `en-US`.

## Notas [#notes]

* Si usas un componente async de App Router, usa [`getLocale`](/docs/react/nextjs/reference/functions/get-locale) en su lugar.
* Para cambiar la configuración regional, usa [`useSetLocale`](/docs/react/reference/hooks/use-set-locale); para consultar la configuración regional de origen, usa [`useDefaultLocale`](/docs/react/reference/hooks/use-default-locale).