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

title: getLocaleProperties
description: Restituisce proprietà dettagliate dell'impostazione regionale senza un'istanza di GT. Riferimento API per getLocaleProperties.

---

[`getLocaleProperties`](/docs/platform/core/reference/gt-class-methods/locales/get-locale-properties) è una funzione di utilità indipendente della libreria Core di General Translation che restituisce proprietà dettagliate per un codice locale, inclusi nome visualizzato, lingua, script e informazioni sulla regione, oltre a un'emoji rappresentativa.

## Panoramica [#overview]

Importa `getLocaleProperties` direttamente da `generaltranslation` e chiamalo con un codice locale e, facoltativamente, un'impostazione regionale per la visualizzazione. Non richiede una chiave API né un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor). Per l'equivalente basato su istanza, usa invece il metodo [`getLocaleProperties`](/docs/platform/core/reference/gt-class-methods/locales/get-locale-properties) di un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor).

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

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

Firma:

```typescript
getLocaleProperties(
  locale: string,
  defaultLocale?: string,
  customMapping?: CustomMapping
): LocaleProperties
```

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

* **Metadati completi.** Restituisce l'oggetto [`LocaleProperties`](/docs/platform/core/reference/types/locale-properties) completo, incluse le forme standard e massimizzate.
* **Nomi nativi.** I nomi nativi vengono sempre calcolati direttamente nell'impostazione regionale di destinazione, indipendentemente da `defaultLocale`.
* **Integrazione delle mappature personalizzate.** Le mappature personalizzate vengono verificate per prime per tutte le proprietà, supportano la risoluzione degli alias e la sovrascrittura delle proprietà e, per i codici non mappati, usano come fallback le API `Intl` standard. Le impostazioni regionali con alias vengono risolte nella loro forma canonica.

*Nota: i nomi visualizzati usano la forma dialettale del CLDR. Ad esempio, `getLocaleProperties('es-MX', 'en').name` è "spagnolo messicano" (non "spagnolo (Messico)"), e `nativeName` è "español de México".*

## Parametri [#parameters]

| Parametro                          | Descrizione                                                   | Tipo                                                                  | Facoltativo | Predefinito |
| ---------------------------------- | ------------------------------------------------------------- | --------------------------------------------------------------------- | ----------- | ----------- |
| [`locale`](#locale)                | Codice locale BCP-47 per cui ottenere le proprietà.           | `string`                                                              | No          | —           |
| [`defaultLocale`](#default-locale) | Impostazione regionale usata per localizzare il nome visualizzato. | `string`                                                              | Sì          | `en`        |
| [`customMapping`](#custom-mapping) | Mappatura personalizzata per i codici locale e le proprietà.    | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sì          | —           |

### `locale` [#locale]

**Tipo** `string` · **Obbligatorio**

Il codice locale BCP-47 di cui ottenere le proprietà.

### `defaultLocale` [#default-locale]

**Tipo** `string` · **Facoltativo** · **Predefinito** `en`

L'impostazione regionale usata per localizzare i nomi visualizzati restituiti.

### `customMapping` [#custom-mapping]

**Tipo** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **Facoltativo**

Una mappatura personalizzata facoltativa per i codici locale e le relative proprietà.

## Returns [#returns]

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

Un oggetto completo che contiene tutte le informazioni sull'impostazione regionale:

* `code`: codice locale standardizzato.
* `name`: nome visualizzato nell'impostazione regionale predefinita.
* `nativeName`: nome visualizzato nell'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.

## Esempi [#examples]

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

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

// Nomi visualizzati in francese
const frProps = getLocaleProperties('es-MX', 'fr');
console.log(frProps.name); // "espagnol du 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 de México"
console.log(frProps.nativeName); // "español de México"
```

## Note [#notes]

* Fornisce i dati dell'impostazione regionale senza istanziare la classe GT.
* Le proprietà della mappatura personalizzata hanno la precedenza sulle API `Intl` standard.
* Viene sempre restituito l'oggetto `LocaleProperties` completo.
* I nomi nativi vengono sempre calcolati direttamente nell'impostazione regionale di destinazione.