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

{/* GENERADO AUTOMÁTICAMENTE: No edites esto directamente. En su lugar, edita el template en content/docs-templates/. */}


## Descripción general

El Hook `useLocale` obtiene la configuración regional actual del usuario desde el [contexto de `<GTProvider>`](/docs/next/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/next/api/components/gtprovider).
</Callout>

## Referencia

### Devuelve

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

***

## Comportamiento de respaldo

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

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 respaldo el idioma más adecuado.

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

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

Consulte 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 actual y muéstrala en tu componente.

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

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

***


## Notas

* El hook `useLocale` depende de [`<GTProvider>`](/docs/next/api/components/gtprovider) para acceder al contexto. Asegúrate de envolver tu aplicación con un provider en el nivel raíz.
* `useLocale` solo funciona del lado del cliente.
* Más información sobre los códigos de configuración regional [aquí](/docs/core/locales).

## Próximos pasos

* Aprende a gestionar y especificar las configuraciones regionales compatibles en tu aplicación con el archivo [`gt.config.json`](/docs/next/api/config/gt-config-json).