# General Translation React SDKs (gt-react, gt-next, gt-react-native): useSetLocale
URL: https://generaltranslation.com/es/docs/react/reference/hooks/use-set-locale.mdx
---
title: useSetLocale
description: Cambia la configuración regional activa. 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`.*

## Descripción general [#overview]

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

*Los ejemplos importan desde `gt-react`; importa desde el paquete de tu framework en su lugar.*

```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, la configuración regional se guarda y se aplica mediante el framework activo:

* React la almacena en una cookie y recarga la página de forma predeterminada.
* Next.js App Router la almacena en una cookie y actualiza el árbol de componentes del servidor. Pages Router puede reemplazar la recarga predeterminada por la navegación de Next.js.
* TanStack Start la almacena en una cookie y recarga la página, o navega al pathname correspondiente cuando [`localeRouting`](/docs/react/reference/config#locale-routing) está habilitado.
* React Native la almacena en el almacenamiento nativo, actualiza el estado del proveedor, carga las traducciones y vuelve a renderizar.

## 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).