# generaltranslation: General Translation Core SDK: getLocaleProperties
URL: https://generaltranslation.com/it/docs/core/class/methods/locales/get-locale-properties.mdx
---
title: getLocaleProperties
description: Documentazione di riferimento per il metodo GT getLocaleProperties
---

## Panoramica

Il metodo `getLocaleProperties` recupera le proprietà complete di un codice locale, fornendo
informazioni dettagliate che includono nomi visualizzati, codici della regione, informazioni sul sistema di scrittura e bandiere emoji.
Restituisce un oggetto `LocaleProperties` completo con tutti i dati necessari per creare interfacce utente internazionalizzate ricche.

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

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

***


## Guida di riferimento

### Parametri

<TypeTable
  type={{
  "locale?": {
    type: 'string',
    optional: true,
    default: 'this.targetLocale',
  }
}}
/>

### Descrizione dei parametri

| Parametro | Descrizione                                                                                                               |
| --------- | ------------------------------------------------------------------------------------------------------------------------- |
| `locale`  | Codice locale BCP-47 di cui recuperare le proprietà. Se non viene fornito, viene usato il `targetLocale` dell&#39;istanza |

### Restituisce

`LocaleProperties` - Un oggetto completo contenente tutte le informazioni sull&#39;impostazione regionale:

* `code`: Codice locale standardizzato
* `name`: Nome visualizzato nell&#39;impostazione regionale di origine
* `nativeName`: Nome visualizzato nell&#39;impostazione regionale stessa
* `languageCode`, `languageName`, `nativeLanguageName`: Informazioni sulla lingua
* `regionCode`, `regionName`, `nativeRegionName`: Informazioni sulla regione
* `scriptCode`, `scriptName`, `nativeScriptName`: Informazioni sul sistema di scrittura
* `maximizedCode`, `minimizedCode`: Forme canoniche
* `nameWithRegionCode`, `nativeNameWithRegionCode`: Formati di visualizzazione combinati
* `emoji`: Bandiera o emoji rappresentativa

### Genera

* `Error` - Se non viene specificata alcuna impostazione regionale e nell&#39;istanza non è configurato alcun `targetLocale`

***

## Esempi

### Utilizzo di base

```typescript
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 (France)"
console.log(props.nativeName); // "français (France)"
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

* Tutti i nomi visualizzati rispettano l&#39;impostazione `sourceLocale` dell&#39;istanza
* Le proprietà di mappatura personalizzate hanno la precedenza rispetto alle API standard di Intl

## Passaggi successivi

* Esplora l&#39;interfaccia [`LocaleProperties`](/docs/core/types/locale-properties)
* Ottieni i nomi semplici delle impostazioni regionali con [`getLocaleName`](/docs/core/class/methods/locales/get-locale-name)
* Ottieni l&#39;emoji dell&#39;impostazione regionale con [`getLocaleEmoji`](/docs/core/class/methods/locales/get-locale-emoji)
* Scopri il tipo [`CustomMapping`](/docs/core/types/custom-mapping)