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

title: useSetLocale
description: Cambia l'impostazione regionale attiva con General Translation gt-react. Riferimento API per useSetLocale.

---

L'hook `useSetLocale` restituisce una funzione che cambia l'impostazione regionale attiva. È disponibile solo lato client.

*Disponibile in `gt-react`, `gt-next`, `gt-tanstack-start` e `gt-react-native`. Gli esempi usano import da `gt-react`; importa invece dal pacchetto del tuo framework.*

## Panoramica [#overview]

Chiama `useSetLocale` per ottenere la funzione setter, quindi chiamala con un codice locale.

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

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

*Nota: `useSetLocale` è disponibile solo lato client.*

## Come funziona [#how-it-works]

Quando richiami la funzione restituita, l&#39;impostazione regionale selezionata viene salvata in un cookie e la pagina viene ricaricata affinché vengano applicate le traduzioni della nuova impostazione regionale.

## Restituisce [#returns]

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

Una funzione che imposta l&#39;impostazione regionale attiva sul codice fornito.

## Note [#notes]

* `useSetLocale` è disponibile solo lato client.
* Per leggere l&#39;impostazione regionale attiva, usa [`useLocale`](/docs/react/reference/hooks/use-locale). Per un selettore già pronto, usa [`<LocaleSelector>`](/docs/react/reference/components/locale-selector).