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

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

---

El hook `useSetLocale` devuelve una función que cambia la configuración regional activa. Solo está disponible del lado del cliente.

*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]

Llama a `useSetLocale` para obtener la función setter y luego úsala con un código de configuración regional.

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

export default function LocaleButton() {
  const setLocale = useSetLocale();
  return <button onClick={() => setLocale('en')}>Set locale</button>;
}
```

*Nota: `useSetLocale` está disponible del lado del cliente.*

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

Al llamar a la función devuelta, se guarda la configuración regional elegida en una cookie y se recarga la página para que se apliquen las traducciones de la nueva configuración regional.

## Devuelve [#returns]

**Tipo** `(locale: string) => void`

Una función que establece la configuración regional activa en el código indicado.

## Notas [#notes]

* `useSetLocale` solo está disponible del lado del cliente.
* Para consultar la configuración regional activa, usa [`useLocale`](/docs/react/reference/hooks/use-locale). Si necesitas un selector listo para usar, utiliza [`<LocaleSelector>`](/docs/react/reference/components/locale-selector).