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

title: useSetLocale
description: Cambia l'impostazione regionale attiva. 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`.*

## Panoramica [#overview]

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

*Gli esempi importano da `gt-react`; importa invece dal package del tuo framework.*

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

La chiamata alla funzione restituita salva e applica l&#39;impostazione regionale tramite il framework attivo:

* React la salva in un cookie e, per impostazione predefinita, ricarica la pagina.
* Next.js App Router la salva in un cookie e aggiorna l&#39;albero dei server component. Pages Router può sostituire il ricaricamento predefinito con la navigazione di Next.js.
* TanStack Start la salva in un cookie e ricarica la pagina oppure passa al pathname corrispondente quando [`localeRouting`](/docs/react/reference/config#locale-routing) è abilitato.
* React Native la salva nello storage nativo, aggiorna lo stato del provider, carica le traduzioni e renderizza nuovamente.

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