# generaltranslation: General Translation Core SDK: getLocaleProperties
URL: https://generaltranslation.com/it/docs/core/functions/locales/get-locale-properties.mdx
---
title: getLocaleProperties
description: Riferimento API per la funzione autonoma getLocaleProperties
---

## Panoramica

La funzione autonoma `getLocaleProperties` recupera le proprietà associate a un codice locale senza richiedere un'istanza della classe GT.
Fornisce informazioni dettagliate, tra cui nomi di visualizzazione, codici regionali, informazioni sullo script e bandiere emoji, in un oggetto `LocaleProperties` completo.

```typescript
import { getLocaleProperties } from 'generaltranslation';

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

***


## Documentazione di riferimento

### Parametri

<TypeTable
  type={{
  "locale": {
    type: 'string',
    optional: false,
  },
  "defaultLocale?": {
    type: 'string',
    optional: true,
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
  }
}}
/>

### Descrizione dei parametri

| Parametro       | Descrizione                                                                                           |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| `locale`        | Codice locale BCP-47 per cui ottenere le proprietà                                                    |
| `defaultLocale` | Impostazione regionale da usare per localizzare i nomi di visualizzazione (predefinita: &#39;en&#39;) |
| `customMapping` | Mappatura personalizzata facoltativa per codici locale e proprietà                                    |

### Restituisce

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

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

***

## Comportamento

### Integrazione con mappature personalizzate

* Le mappature personalizzate vengono verificate per prime per tutte le proprietà
* Supporta la risoluzione degli alias e la sovrascrittura delle proprietà
* Per i codici non mappati, usa come fallback le API Intl standard
* Risoluzione dell&#39;impostazione regionale standard per le impostazioni regionali con alias

***

## Esempi

```typescript
import { getLocaleProperties } from 'generaltranslation';

// Nomi di visualizzazione in inglese
const enProps = getLocaleProperties('es-MX', 'en');
console.log(enProps.name); // "Spanish (Mexico)"
console.log(enProps.languageName); // "Spanish"
console.log(enProps.regionName); // "Mexico"
console.log(enProps.emoji); // "🇲🇽"

// Nomi di visualizzazione in francese
const frProps = getLocaleProperties('es-MX', 'fr');
console.log(frProps.name); // "espagnol (Mexique)"
console.log(frProps.languageName); // "espagnol"
console.log(frProps.regionName); // "Mexique"

// I nomi nativi sono sempre nell'impostazione regionale di destinazione
console.log(enProps.nativeName); // "español (México)"
console.log(frProps.nativeName); // "español (México)"
```

***


## Note

* La funzione fornisce i dati dell&#39;impostazione regionale senza istanziare la classe GT
* Le proprietà di mappatura personalizzate hanno la precedenza sulle API `Intl` standard
* Viene sempre restituita l&#39;interfaccia `LocaleProperties` completa
* I nomi nativi vengono sempre calcolati direttamente nell&#39;impostazione regionale di destinazione

## Passaggi successivi

* Esplora l&#39;interfaccia [`LocaleProperties`](/docs/core/types/locale-properties) - Documentazione completa dell&#39;interfaccia
* Usa il metodo della classe GT [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties)
* Ottieni i nomi semplici delle impostazioni regionali con [`getLocaleName`](/docs/core/functions/locales/get-locale-name)
* Ottieni l&#39;emoji dell&#39;impostazione regionale con [`getLocaleEmoji`](/docs/core/functions/locales/get-locale-emoji)