# react-native: useLocale
URL: https://generaltranslation.com/es/docs/react-native/api/helpers/use-locale.mdx
---
title: useLocale
description: Referencia de la API para el hook useLocale
---

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


## Descripción general

El hook `useLocale` recupera la configuración regional actual del usuario del [contexto de `<GTProvider>`](/docs/react-native/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-native/api/components/gtprovider).
</Callout>

## Referencia

### Devuelve

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

***

## Comportamiento de fallback

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

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 fallback la mejor coincidencia de idioma.

Además, si no hay ninguna configuración regional alternativa posible,
pero dos configuraciones regionales comparten el mismo idioma (por ejemplo, `en-US` y `en-GB`),
entonces se usará como fallback 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-native/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-native';

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

***


## Notas

* El hook `useLocale` depende de [`<GTProvider>`](/docs/react-native/api/components/gtprovider) para acceder al contexto. Asegúrate de que tu aplicación esté envuelta en un proveedor en el nivel raíz.
* `useLocale` solo funciona 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 administrar y especificar las configuraciones regionales compatibles que admite tu aplicación con el archivo [`gt.config.json`](/docs/react-native/api/config/gt-config-json).