# react-native: useLocales
URL: https://generaltranslation.com/es/docs/react-native/api/helpers/use-locales.mdx
---
title: useLocales
description: Referencia de la API del hook useLocales
---

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


## Resumen

El hook `useLocales` obtiene la lista de configuraciones regionales compatibles del [contexto de `<GTProvider>`](/docs/react-native/api/components/gtprovider).

<Callout>
  `useLocales` 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>

Para su uso del lado del servidor, consulta [`getLocales`](/docs/react-native/api/helpers/get-locales).

## Referencia

### Devuelve

`string[]` — Un array de [códigos de configuración regional](/docs/core/locales) de BCP 47 que representa las configuraciones regionales compatibles, por ejemplo, `['en-US', 'fr', 'ja']`.

***

## Ejemplos

### Uso básico

```jsx title="LocaleList.jsx" copy
'use client';
import { useLocales } from 'gt-react-native';

export default function LocaleList() {
  const locales = useLocales(); // [!code highlight]
  return (
    <ul>
      {locales.map((locale) => (
        <li key={locale}>{locale}</li>
      ))}
    </ul>
  );
}
```

***


## Notas

* El hook `useLocales` 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.
* `useLocales` es solo del lado del cliente. Para los componentes del servidor, usa [`getLocales`](/docs/react-native/api/helpers/get-locales).

## Siguientes pasos

* Aprende a configurar las configuraciones regionales compatibles en [`gt.config.json`](/docs/react-native/api/config/gt-config-json).
* Consulta [`getLocales`](/docs/react-native/api/helpers/get-locales) para ver el equivalente del lado del servidor.