# General Translation Platform: getLocaleProperties
URL: https://generaltranslation.com/it/docs/platform/core/reference/gt-class-methods/locales/get-locale-properties.mdx
---

title: getLocaleProperties
description: Restituisce proprietà dettagliate relative a lingua, sistema di scrittura, regione e direzione per un'impostazione regionale. Riferimento API per getLocaleProperties.

---

Recupera le proprietà complete di un codice locale su un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor), inclusi nomi visualizzati, lingua, sistema di scrittura, informazioni sulla regione e una bandiera emoji. General Translation restituisce un oggetto [`LocaleProperties`](/docs/platform/core/reference/types/locale-properties) completo con i dati necessari per creare interfacce utente internazionalizzate avanzate.

## Panoramica [#overview]

Chiama `getLocaleProperties` su un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor) con un codice locale facoltativo. Se viene omesso, viene usato il `targetLocale` dell'istanza.

```typescript
const gt = new GT({ sourceLocale: 'en', targetLocale: 'es' });

const props = gt.getLocaleProperties('fr-CA');
console.log(props.name); // "Canadian French"
console.log(props.nativeName); // "français canadien"
console.log(props.emoji); // "🇨🇦"
```

Firma:

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

*Nota: `getLocaleProperties` viene eseguito localmente e non richiede una chiave API. Usa il `targetLocale` dell'istanza quando `locale` viene omesso e il `sourceLocale` dell'istanza per i nomi visualizzati. Per le ricerche senza un'istanza `GT`, consulta la versione autonoma di [`getLocaleProperties`](/docs/platform/core/reference/utility-functions/locales/get-locale-properties).*

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

* **Forme massimizzate e minimizzate.** Il metodo ricava sia una forma massimizzata (con sistema di scrittura e regione probabili aggiunti) sia una forma minimizzata del codice locale.
* **Lingua di visualizzazione.** Tutti i nomi visualizzati rispettano l'impostazione `sourceLocale` dell'istanza.
* **Priorità di `CustomMapping`.** Le proprietà definite in un [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) hanno la precedenza sulle API `Intl` standard.
* **Fallback dell'impostazione regionale.** Quando `locale` viene omesso, viene usato il `targetLocale` dell'istanza.
* **Impostazione regionale mancante.** Solleva un `Error` se non viene fornita alcuna impostazione regionale e l'istanza non ha alcun `targetLocale` configurato.

## Parametri [#parameters]

| Parametro           | Descrizione                                         | Type     | Optional | Predefinito         |
| ------------------- | --------------------------------------------------- | -------- | -------- | ------------------- |
| [`locale`](#locale) | Codice locale BCP-47 per cui ottenere le proprietà. | `string` | Sì       | `this.targetLocale` |

### `locale` [#locale]

**Tipo** `string` · **Facoltativo** · **Predefinito** `this.targetLocale`

Codice locale BCP-47 di cui ottenere le proprietà (ad esempio `"de-AT"`). Se non specificato, viene usato il `targetLocale` dell'istanza.

## Returns [#returns]

**Type** [`LocaleProperties`](/docs/platform/core/reference/types/locale-properties)

Un oggetto completo che descrive l'impostazione regionale:

* `code`: il codice locale completo (ad esempio `"de-AT"`).
* `name`: il nome della lingua nella lingua di visualizzazione (ad esempio `"Austrian German"`).
* `nativeName`: il nome della lingua nella lingua nativa dell'impostazione regionale (ad esempio `"Österreichisches Deutsch"`).
* `languageCode`, `languageName`, `nativeLanguageName`: informazioni di base sulla lingua.
* `nameWithRegionCode`, `nativeNameWithRegionCode`: il nome della lingua con il codice regionale (ad esempio `"German (AT)"`).
* `regionCode`, `regionName`, `nativeRegionName`: informazioni sulla regione.
* `scriptCode`, `scriptName`, `nativeScriptName`: informazioni sul sistema di scrittura.
* `maximizedCode`, `maximizedName`, `nativeMaximizedName`: forme estese con sistema di scrittura e regione probabili.
* `minimizedCode`, `minimizedName`, `nativeMinimizedName`: forme ridotte.
* `emoji`: la bandiera o l'emoji rappresentativa della regione dell'impostazione regionale.

Genera un `Error` se non viene fornita alcuna impostazione regionale e nell'istanza non è configurato alcun `targetLocale`.

## Esempi [#examples]

```typescript
// Utilizzo di base
const gt = new GT({ sourceLocale: 'en', targetLocale: 'fr' });

// Ottieni le proprietà per l'impostazione regionale di destinazione
const props = gt.getLocaleProperties();
console.log(props.name); // "French"
console.log(props.nativeName); // "français"
console.log(props.languageCode); // "fr"
console.log(props.regionCode); // "FR"
console.log(props.emoji); // "🇫🇷"

// Ottieni le proprietà per altre impostazioni regionali
const germanProps = gt.getLocaleProperties('de-AT');
console.log(germanProps.name); // "Austrian German"
console.log(germanProps.nativeName); // "Österreichisches Deutsch"
console.log(germanProps.regionName); // "Austria"
console.log(germanProps.nativeRegionName); // "Österreich"
```

## Note [#notes]

* Tutti i nomi visualizzati seguono l'impostazione `sourceLocale` dell'istanza.
* Le proprietà di Custom mapping hanno la precedenza rispetto alle API `Intl` standard.