# 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
Docs index: https://generaltranslation.com/llms.txt
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 normalmente actualiza el árbol de componentes del servidor. Con el enrutamiento de configuración regional habilitado, al cambiar a la configuración regional predeterminada desde una URL que se resuelve en una configuración regional no predeterminada, se recarga el documento para que el middleware pueda eliminar el prefijo de configuración regional. Una URL que ya se resuelve en la configuración regional predeterminada solo se actualiza. 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).

## Historial de versiones [#version-history]

| Versión | Cambios                                                                                                                                                                                                          |
| ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 11.1.16 | La selección de la configuración regional predeterminada en una URL sin prefijo del App Router, o que se resuelve en la predeterminada, actualiza los componentes de servidor en lugar de recargar el documento. |

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.