# node: getLocaleProperties
URL: https://generaltranslation.com/it/docs/node/api/get-locale-properties.mdx
---
title: getLocaleProperties
description: Riferimento API della funzione getLocaleProperties
---

## Panoramica

La funzione `getLocaleProperties` restituisce i metadati di una determinata impostazione regionale, inclusi nome, nome nella lingua locale, lingua, area geografica e informazioni sulla scrittura.

```js
import { getLocaleProperties } from 'gt-node';

const props = getLocaleProperties('en-US');
console.log(props.name); // 'Inglese americano'
```


## Riferimento

### Parametri

| Parametro | Tipo     | Descrizione                                                                                                              |
| --------- | -------- | ------------------------------------------------------------------------------------------------------------------------ |
| `locale`  | `string` | Un codice locale BCP 47 (ad esempio `'en-US'`, `'ja'`). Se non è specificato, usa l'impostazione regionale corrente. |

### Restituisce

Un oggetto `LocaleProperties` con i seguenti campi:

| Campo                      | Tipo     | Descrizione                                                                                          |
| -------------------------- | -------- | ---------------------------------------------------------------------------------------------------- |
| `code`                     | `string` | Il codice locale (ad es. `'en-US'`).                                                                 |
| `name`                     | `string` | Il nome in inglese dell'impostazione regionale (ad es. `'American English'`).                    |
| `nativeName`               | `string` | Il nome nella lingua dell'impostazione regionale (ad es. `'American English'`).                  |
| `languageCode`             | `string` | Il sottotag della lingua (ad es. `'en'`).                                                            |
| `languageName`             | `string` | Il nome in inglese della lingua (ad es. `'English'`).                                                |
| `nativeLanguageName`       | `string` | Il nome della lingua nella lingua stessa (ad es. `'English'`).                                       |
| `nameWithRegionCode`       | `string` | Il nome dell'impostazione regionale che include l'area geografica (ad es. `'English (US)'`). |
| `nativeNameWithRegionCode` | `string` | Il nome nativo dell'impostazione regionale che include l'area geografica.                    |
| `regionCode`               | `string` | Il sottotag dell'area geografica (ad es. `'US'`).                                                |
| `regionName`               | `string` | Il nome in inglese dell'area geografica (ad es. `'United States'`).                              |
| `nativeRegionName`         | `string` | Il nome dell'area geografica nella lingua dell'impostazione regionale.                       |
| `scriptCode`               | `string` | Il sottotag della scrittura (ad es. `'Latn'`).                                                       |
| `scriptName`               | `string` | Il nome in inglese della scrittura (ad es. `'Latin'`).                                               |
| `nativeScriptName`         | `string` | Il nome della scrittura nella lingua dell'impostazione regionale.                                |
| `maximizedCode`            | `string` | Il codice locale completamente espanso (ad es. `'en-Latn-US'`).                                      |

***

## Esempi

### Utilizzo di base

```js title="handler.js"
import { getLocaleProperties } from 'gt-node';

app.get('/api/locale-info', (req, res) => {
  const props = getLocaleProperties('ja');
  res.json({
    name: props.name,           // 'Japanese'
    nativeName: props.nativeName, // '日本語'
    script: props.scriptName,   // 'Japanese'
  });
});
```

***


## Note

* Questa funzione è sincrona e non richiede `await`.
* Utile per creare selettori delle impostazioni regionali o mostrare agli utenti i metadati delle impostazioni regionali.

## Passaggi successivi

* Consulta [`getLocale`](/docs/node/api/get-locale) per conoscere l'impostazione regionale della richiesta corrente.
* Scopri di più sui [codici locale](/docs/core/locales).