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

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

---

L&#39;hook `useLocale` restituisce l&#39;impostazione regionale corrente dell&#39;utente dal context di [`<GTProvider>`](/docs/react/reference/components/gt-provider), sotto forma di codice locale BCP 47, ad esempio `en-US`.

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

## Panoramica [#overview]

Chiama `useLocale` per ottenere l&#39;impostazione regionale attiva.

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

export default function CurrentLocale() {
  const locale = useLocale(); // [!code highlight]
  return <p>Current locale: {locale}</p>;
}
```

*Nota: In `gt-react`, usa `useLocale` all&#39;interno di [`<GTProvider>`](/docs/react/reference/components/gt-provider). In `gt-next`, funziona anche nei componenti server sincroni.*

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

Quando viene richiesta un&#39;impostazione regionale non supportata, viene selezionato un fallback:

* Se l&#39;utente ha configurato nel browser più impostazioni regionali preferite e una di queste è supportata, viene usata la lingua supportata più adatta.
* In caso contrario, se due impostazioni regionali condividono la stessa lingua (ad esempio, `en-US` e `en-GB`), viene usata l&#39;impostazione regionale supportata che condivide quella lingua.
* Se non si verifica nessuno di questi casi, viene usata l&#39;[impostazione regionale predefinita](/docs/react/reference/config#default-locale).

## Returns [#returns]

**Type** `string`

L&#39;impostazione regionale attuale dell&#39;utente, ad esempio `en-US`.

## Note [#notes]

* In un componente asincrono di App Router, usa invece [`getLocale`](/docs/react/nextjs/reference/functions/get-locale).
* Per cambiare l&#39;impostazione regionale, usa [`useSetLocale`](/docs/react/reference/hooks/use-set-locale); per leggere l&#39;impostazione regionale sorgente, usa [`useDefaultLocale`](/docs/react/reference/hooks/use-default-locale).