# generaltranslation: General Translation Core SDK: getLocaleProperties
URL: https://generaltranslation.com/fr/docs/core/class/methods/locales/get-locale-properties.mdx
---
title: getLocaleProperties
description: Référence de l’API pour la méthode GT getLocaleProperties
---

## Vue d’ensemble

La méthode `getLocaleProperties` récupère l’ensemble des propriétés d’un code de langue et fournit
des informations détaillées, notamment les noms d’affichage, les codes de région, les informations sur le système d’écriture et les drapeaux emoji.
Elle renvoie un objet `LocaleProperties` complet contenant toutes les données nécessaires pour créer des interfaces utilisateur internationalisées complètes.

```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); // "🇨🇦"
```

***


## Référence

### Paramètres

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

### Description des paramètres

| Paramètre | Description                                                                                                                                                      |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `locale`  | Code de langue BCP-47 du paramètre régional dont il faut obtenir les propriétés. S&#39;il n&#39;est pas fourni, le `targetLocale` de l&#39;instance est utilisé. |

### Retourne

`LocaleProperties` - Un objet complet contenant toutes les informations sur le paramètre régional :

* `code`: Code de langue normalisé
* `name`: Nom d’affichage dans le paramètre régional source
* `nativeName`: Nom d’affichage dans le paramètre régional lui-même
* `languageCode`, `languageName`, `nativeLanguageName`: Informations sur la langue
* `regionCode`, `regionName`, `nativeRegionName`: Informations sur la région
* `scriptCode`, `scriptName`, `nativeScriptName`: Informations sur le système d’écriture
* `maximizedCode`, `minimizedCode`: Formes canoniques
* `nameWithRegionCode`, `nativeNameWithRegionCode`: Formats d’affichage combinés
* `emoji`: Drapeau ou emoji représentatif

### Lève

* `Error` - Si aucun paramètre régional n’est fourni et qu’aucun `targetLocale` n’est configuré pour l’instance

***

## Exemples

### Utilisation de base

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

// Obtenir les propriétés pour le paramètre régional cible
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); // "🇫🇷"

// Obtenir les propriétés pour d'autres paramètres régionaux
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"
```

***


## Remarques

* Tous les noms d’affichage s’alignent sur le paramètre `sourceLocale` de l’instance
* Les propriétés de correspondance personnalisées ont priorité sur les API Intl standard

## Étapes suivantes

* Découvrez l’interface [`LocaleProperties`](/docs/core/types/locale-properties)
* Obtenez les noms simplifiés des paramètres régionaux avec [`getLocaleName`](/docs/core/class/methods/locales/get-locale-name)
* Obtenez l’emoji du paramètre régional avec [`getLocaleEmoji`](/docs/core/class/methods/locales/get-locale-emoji)
* Découvrez le type [`CustomMapping`](/docs/core/types/custom-mapping)