# gt-react: General Translation React SDK: useLocale
URL: https://generaltranslation.com/it/docs/react/api/helpers/use-locale.mdx
---
title: useLocale
description: Riferimento dell'API per l'hook useLocale
---

{/* GENERATO AUTOMATICAMENTE: non modificare direttamente. Modifica invece il modello in content/docs-templates/. */}


## Panoramica

L&#39;hook `useLocale` ottiene l&#39;impostazione regionale corrente dell&#39;utente dal [contesto `<GTProvider>`](/docs/react/api/components/gtprovider).
L&#39;impostazione regionale viene restituita come [codice locale](/docs/core/locales) BCP 47, ad esempio `'en-US'`.

<Callout>
  `useLocale` è un hook lato client e *può essere utilizzato solo nei componenti lato client*.
  Assicurati che la tua app sia racchiusa in un [`<GTProvider>`](/docs/react/api/components/gtprovider).
</Callout>

## Riferimento

### Restituisce

Una stringa che rappresenta l&#39;impostazione regionale corrente dell&#39;utente, ad esempio `'en-US'`.

***

## Comportamento di fallback

Quando viene richiesta un&#39;impostazione regionale non supportata, verrà selezionata un&#39;impostazione regionale di fallback.

Ad esempio, nel caso di un&#39;impostazione regionale non supportata,
se (1) l&#39;utente ha configurato più impostazioni regionali preferite nelle impostazioni del browser
e (2) una di queste impostazioni regionali è supportata dalla tua applicazione,
allora verrà usata come fallback la lingua più adatta.

Inoltre, se non è disponibile alcuna impostazione regionale di fallback,
ma due impostazioni regionali condividono la stessa lingua (ad esempio, `en-US` e `en-GB`),
allora verrà usata come fallback l&#39;impostazione regionale supportata che condivide la stessa lingua.

Se nessuna delle due condizioni è soddisfatta, verrà usata l&#39;impostazione regionale predefinita.

Consulta la documentazione di [`gt.config.json`](/docs/react/api/config/gt-config-json) per informazioni su come configurare le impostazioni regionali supportate.

***

## Esempi

### Utilizzo di base

Recupera l’impostazione regionale corrente e visualizzala nel componente.

```jsx title="CurrentLocale.jsx" copy
'use client';
import { useLocale } from 'gt-react';

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

***


## Note

* L&#39;hook `useLocale` si appoggia a [`<GTProvider>`](/docs/react/api/components/gtprovider) per accedere al contesto. Assicurati che la tua app sia racchiusa in un provider al livello root.
* `useLocale` è disponibile solo lato client.
* Scopri di più sui codici locale [qui](/docs/core/locales).

## Passaggi successivi

* Scopri come gestire e specificare le impostazioni regionali supportate nella tua applicazione con il file [`gt.config.json`](/docs/react/api/config/gt-config-json).