# gt-react: General Translation React SDK: useLocale
URL: https://generaltranslation.com/es/docs/react/api/helpers/use-locale.mdx
---
title: useLocale
description: Referencia de la API del hook useLocale
---

{/* GENERADO AUTOMÁTICAMENTE: No edites esto directamente. Edita la plantilla en content/docs-templates/. */}


## Descripción general

El hook `useLocale` obtiene la configuración regional actual del usuario desde el [contexto de `<GTProvider>`](/docs/react/api/components/gtprovider).
La configuración regional se devuelve como un [código de configuración regional](/docs/core/locales) BCP 47, por ejemplo, `'en-US'`.

<Callout>
  `useLocale` es un hook del lado del cliente y *solo puede usarse en componentes del lado del cliente*.
  Asegúrate de que tu aplicación esté envuelta en un [`<GTProvider>`](/docs/react/api/components/gtprovider).
</Callout>

## Referencia

### Devuelve

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

***

## Comportamiento de reserva

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

Por ejemplo, si se solicita 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á como reserva el idioma más adecuado.

Además, si no hay ninguna configuración regional de reserva disponible,
pero dos configuraciones regionales comparten el mismo idioma (p. ej., `en-US` y `en-GB`),
entonces se usará como reserva 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/react/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 actual y muéstrala en tu componente.

```jsx title="CurrentLocale.jsx" copy
'use client';
import { useLocale } from 'gt-react';

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

***


## Notas

* El hook `useLocale` depende de [`<GTProvider>`](/docs/react/api/components/gtprovider) para acceder al contexto. Asegúrate de que tu aplicación esté envuelta en un proveedor en la raíz.
* `useLocale` solo está disponible del lado del cliente.
* Obtén más información sobre los códigos de configuración regional [aquí](/docs/core/locales).

## Próximos pasos

* Aprende a gestionar y especificar la configuración regional compatible en tu aplicación con el archivo [`gt.config.json`](/docs/react/api/config/gt-config-json).