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

## Vue d’ensemble

La méthode `getLocaleName` récupère le nom d’affichage d’un code de langue à l’aide de l’API `Intl.DisplayNames`.
Elle renvoie un nom compréhensible pour tout code de langue BCP-47 valide, localisé selon le paramètre régional source de l’instance.

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

const name = gt.getLocaleName('fr-CA');
console.log(name); // "French (Canada)"
```

***


## 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 récupérer le nom d’affichage. S’il n’est pas fourni, le `targetLocale` de l’instance est utilisé |

### Renvoie

`chaîne de caractères` - Le nom d’affichage localisé du paramètre régional.

### Lève une exception

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

***

## Comportement

### Langue d’affichage

Le nom d’affichage est localisé en fonction de :

1. `sourceLocale` de l’instance (s’il est configuré)
2. Le paramètre régional par défaut de la bibliothèque (&#39;en&#39;)

### Intégration de mappages personnalisés

* Les mappages personnalisés des paramètres régionaux sont vérifiés en premier
* Si un nom personnalisé est défini, il est utilisé en priorité
* Utilise `Intl.DisplayNames` comme solution de repli pour les codes BCP-47 standard

***

## Exemples

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

// Obtenir le nom du paramètre régional cible
console.log(gt.getLocaleName()); // "French (France)"

// Obtenir les noms des autres paramètres régionaux
console.log(gt.getLocaleName('es')); // "Spanish (Spain)"
console.log(gt.getLocaleName('de')); // "German (Germany)"
console.log(gt.getLocaleName('ja')); // "Japanese (Japan)"
```

***


## Remarques

* La méthode utilise le `sourceLocale` de l’instance pour déterminer la langue affichée
* Les noms de mappage personnalisés prennent le pas sur `Intl.DisplayNames` standard

## Étapes suivantes

* Récupérez l’emoji du paramètre régional avec [`getLocaleEmoji`](/docs/core/class/methods/locales/get-locale-emoji)
* Récupérez des informations complètes sur le paramètre régional avec [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties)
* [En savoir plus sur le type CustomMapping](/docs/core/types/custom-mapping)