# gt-next: General Translation Next.js SDK: getLocale
URL: https://generaltranslation.com/it/docs/next/api/helpers/get-locale.mdx
---
title: getLocale
description: Documentazione di riferimento dell'API per il metodo lato server getLocale
---

## Panoramica

La funzione `getLocale` recupera l'impostazione regionale corrente dell'utente durante il rendering lato server.
L'impostazione regionale viene restituita come [codice locale](/docs/core/locales) BCP 47, ad esempio `'en-US'`.

<Callout>
  `getLocale` è un metodo lato server e può essere usato solo nei componenti
  lato server.
</Callout>

Per l&#39;utilizzo lato client, vedi [`useLocale`](/docs/next/api/helpers/use-locale).

## Riferimento

### Restituisce

Una promise che 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 dall&#39;applicazione,
verrà scelta 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 compatibili.

***

## Esempi

### Uso di base

Recupera l&#39;impostazione regionale dell&#39;utente durante il rendering lato server.

```javascript title="GetUserLocale.jsx" copy
import { getLocale } from 'gt-next/server';

export default async function GetUserLocale() {
  const locale = await getLocale(); // [!code highlight]
  return <p>User locale: {locale}</p>;
}
```

***


## Note

* La funzione `getLocale` è asincrona e deve essere attesa con `await` per ottenere l&#39;impostazione regionale.
* È progettata specificamente per l&#39;uso lato server. Per i componenti lato client, consulta [`useLocale`](/docs/next/api/helpers/use-locale).
* L&#39;impostazione regionale restituita segue il formato del [codice locale](/docs/core/locales).

## Passaggi successivi

* Scopri come configurare le impostazioni regionali compatibili con [withGTConfig()](/docs/next/api/config/with-gt-config).