# gt-next: General Translation Next.js SDK: useLocale
URL: https://generaltranslation.com/it/docs/next/api/helpers/use-locale.mdx
---
title: useLocale
description: Riferimento API dell'Hook useLocale
---

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


## Panoramica

L&#39;hook `useLocale` recupera l&#39;impostazione regionale attuale dell&#39;utente dal [contesto di `<GTProvider>`](/docs/next/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 usato solo nei componenti lato client*.
  Assicurati che la tua app sia avvolta da un [`<GTProvider>`](/docs/next/api/components/gtprovider).
</Callout>

## Documentazione di riferimento

### Restituisce

Una stringa che rappresenta l&#39;impostazione regionale attuale 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 dall&#39;applicazione,
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`),
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/next/api/config/gt-config-json) per informazioni su come configurare le impostazioni regionali supportate.

***

## Esempi

### Utilizzo di base

Recupera l&#39;impostazione regionale corrente e visualizzala nel componente.

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

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

***


## Note

* L&#39;hook `useLocale` si basa su [`<GTProvider>`](/docs/next/api/components/gtprovider) per accedere al contesto. Assicurati che l&#39;app sia avvolta da un provider a livello della radice.
* `useLocale` è disponibile solo lato client.
* Scopri di più sui codici locale [qui](/docs/core/locales).

## Passaggi successivi

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