# react-native: useLocale
URL: https://generaltranslation.com/it/docs/react-native/api/helpers/use-locale.mdx
---
title: useLocale
description: Riferimento API dell'hook useLocale
---

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


## Panoramica

L&#39;hook `useLocale` recupera l&#39;impostazione regionale attuale dell&#39;utente dal [contesto `<GTProvider>`](/docs/react-native/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 del lato del cliente e *può essere usato solo nei componenti del lato del cliente*.
  Assicurati che la tua app sia racchiusa in un [`<GTProvider>`](/docs/react-native/api/components/gtprovider).
</Callout>

## 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, viene 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à scelta come fallback la corrispondenza linguistica migliore.

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 quella lingua.

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

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

***

## 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-react-native';

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/react-native/api/components/gtprovider) per accedere al contesto. Assicurati che la tua app sia avvolta da un provider al livello root.
* `useLocale` è solo sul 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 tramite il file [`gt.config.json`](/docs/react-native/api/config/gt-config-json).