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

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


## Panoramica

L'hook `useLocaleProperties` restituisce i metadati di una determinata impostazione regionale, inclusi nome, nome nativo, lingua, regione e informazioni sulla scrittura.

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

## Riferimento

### Parametri

| Parametro | Tipo     | Descrizione                                                    |
| --------- | -------- | -------------------------------------------------------------- |
| `locale`  | `string` | Un codice locale conforme a BCP 47 (ad es. `'en-US'`, `'ja'`). |

### Restituisce

Un oggetto `LocaleProperties` con i seguenti campi:

| Campo                      | Tipo     | Descrizione                                                                                |
| -------------------------- | -------- | ------------------------------------------------------------------------------------------ |
| `code`                     | `string` | Il codice locale (ad esempio `'en-US'`).                                                   |
| `name`                     | `string` | Il nome in inglese dell&#39;impostazione regionale (ad esempio `'American English'`).      |
| `nativeName`               | `string` | Il nome nell&#39;impostazione regionale stessa.                                            |
| `languageCode`             | `string` | Il sottotag della lingua (ad esempio `'en'`).                                              |
| `languageName`             | `string` | Il nome della lingua in inglese.                                                           |
| `nativeLanguageName`       | `string` | Il nome della lingua nella lingua stessa.                                                  |
| `nameWithRegionCode`       | `string` | Il nome dell&#39;impostazione regionale, inclusa la regione (ad esempio `'English (US)'`). |
| `nativeNameWithRegionCode` | `string` | Il nome nativo dell&#39;impostazione regionale, inclusa la regione.                        |
| `regionCode`               | `string` | Il sottotag della regione (ad esempio `'US'`).                                             |
| `regionName`               | `string` | Il nome della regione in inglese.                                                          |
| `nativeRegionName`         | `string` | Il nome della regione nella lingua dell&#39;impostazione regionale stessa.                 |
| `scriptCode`               | `string` | Il sottotag della scrittura (ad esempio `'Latn'`).                                         |
| `scriptName`               | `string` | Il nome della scrittura in inglese.                                                        |
| `nativeScriptName`         | `string` | Il nome della scrittura nella lingua dell&#39;impostazione regionale stessa.               |
| `maximizedCode`            | `string` | Il codice locale completamente espanso (ad esempio `'en-Latn-US'`).                        |

***

## Esempi

### Utilizzo di base

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

export default function LocaleInfo() {
  const locale = useLocale();
  const props = useLocaleProperties(locale); // [!code highlight]
  return (
    <div>
      <p>Name: {props.name}</p>
      <p>Native name: {props.nativeName}</p>
      <p>Region: {props.regionName}</p>
    </div>
  );
}
```

***


## Note

* Questo hook è sincrono: restituisce direttamente le proprietà.
* Utile per creare selettori personalizzati delle impostazioni regionali o per mostrare agli utenti i metadati delle impostazioni regionali.

## Passaggi successivi

* Scopri di più sui [codici locale](/docs/core/locales).