# gt-node: General Translation Node.js SDK: getLocaleProperties
URL: https://generaltranslation.com/it/docs/node/reference/functions/get-locale-properties.mdx
---
title: getLocaleProperties
description: Legge i metadati di visualizzazione di un'impostazione regionale in General Translation gt-node. Riferimento API per getLocaleProperties.

---

Restituisce i metadati di un'impostazione regionale — nome, nome nativo, lingua, regione e informazioni sul sistema di scrittura. Usalo per creare selettori dell'impostazione regionale o per mostrare agli utenti i relativi metadati.

## Panoramica [#overview]

Chiama `getLocaleProperties` con un codice locale oppure senza argomenti per usare l'impostazione regionale corrente. Restituisce un oggetto [`LocaleProperties`](/docs/platform/core/reference/types/locale-properties).

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

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

Firma:

```ts
getLocaleProperties(locale?: string): LocaleProperties
```

*Nota: questa funzione è sincrona — non è necessario usare `await`.*

## Come funziona [#how-it-works]

* **Fallback dell'impostazione regionale.** Quando `locale` viene omesso, indica l'impostazione regionale corrente.
* **Sottotag derivati.** Risolve i sottotag di lingua, sistema di scrittura e regione e i relativi nomi visualizzati, oltre alle forme massimizzate.
* **Sincrono.** Restituisce immediatamente il risultato e non richiede alcuna richiesta di rete.

## Parametri [#parameters]

| Parametro           | Descrizione                            | Tipo     | Facoltativo | Predefinito                     |
| ------------------- | -------------------------------------- | -------- | ----------- | ------------------------------- |
| [`locale`](#locale) | Il codice locale BCP 47 da descrivere. | `string` | Sì          | Impostazione regionale corrente |

### `locale` [#locale]

**Tipo** `string` · **Facoltativo** · **Predefinito** Impostazione regionale corrente

Un codice locale BCP 47 (ad esempio `'en-US'`, `'ja'`). Se non viene specificato, viene usata l'impostazione regionale corrente.

## Restituisce [#returns]

**Tipo** `LocaleProperties`

Un oggetto `LocaleProperties` con i seguenti campi:

| Campo                      | Tipo     | Descrizione                                                                                              |
| -------------------------- | -------- | -------------------------------------------------------------------------------------------------------- |
| `code`                     | `string` | Il codice locale (ad esempio, `'en-US'`).                                                                |
| `name`                     | `string` | Il nome inglese dell'impostazione regionale (ad esempio, `'American English'`).                      |
| `nativeName`               | `string` | Il nome dell'impostazione regionale nella sua lingua (ad esempio, `'American English'`).             |
| `languageCode`             | `string` | Il sottotag della lingua (ad esempio, `'en'`).                                                           |
| `languageName`             | `string` | Il nome inglese della lingua (ad esempio, `'English'`).                                                  |
| `nativeLanguageName`       | `string` | Il nome della lingua nella sua lingua (ad esempio, `'English'`).                                         |
| `nameWithRegionCode`       | `string` | Il nome dell'impostazione regionale, inclusa la regione (ad esempio, `'English (US)'`).              |
| `nativeNameWithRegionCode` | `string` | Il nome nativo dell'impostazione regionale, inclusa la regione.                                      |
| `regionCode`               | `string` | Il sottotag della regione (ad esempio, `'US'`).                                                          |
| `regionName`               | `string` | Il nome inglese della regione (ad esempio, `'United States'`).                                           |
| `nativeRegionName`         | `string` | Il nome della regione nella lingua dell'impostazione regionale.                                      |
| `scriptCode`               | `string` | Il sottotag del sistema di scrittura (ad esempio, `'Latn'`).                                             |
| `scriptName`               | `string` | Il nome inglese del sistema di scrittura (ad esempio, `'Latin'`).                                        |
| `nativeScriptName`         | `string` | Il nome del sistema di scrittura nella lingua dell'impostazione regionale.                           |
| `maximizedCode`            | `string` | Il codice locale completamente espanso (ad esempio, `'en-Latn-US'`).                                     |
| `maximizedName`            | `string` | Il nome inglese dell'impostazione regionale massimizzata (ad esempio, `'American English (Latin)'`). |
| `nativeMaximizedName`      | `string` | Il nome dell'impostazione regionale massimizzata nella sua lingua.                                   |
| `minimizedCode`            | `string` | Il codice locale minimo (ad esempio, `'en'`).                                                            |
| `minimizedName`            | `string` | Il nome inglese dell'impostazione regionale minimizzata.                                             |
| `nativeMinimizedName`      | `string` | Il nome dell'impostazione regionale minimizzata nella sua lingua.                                    |
| `emoji`                    | `string` | Una bandiera o un'emoji rappresentativa dell'impostazione regionale.                             |

## Esempi [#examples]

```ts title="handler.js"
// Utilizzo di base
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 [#notes]

* Questa funzione è sincrona: non deve essere attesa.
* Utile per creare selettori dell'impostazione regionale o per mostrare agli utenti i metadati dell'impostazione regionale.