# generaltranslation: General Translation Core SDK: getLocaleName
URL: https://generaltranslation.com/fr/docs/core/functions/locales/get-locale-name.mdx
---
title: getLocaleName
description: Référence de l’API de la fonction autonome getLocaleName
---

## Vue d’ensemble

La fonction autonome `getLocaleName` récupère le nom d’affichage d’un code de langue sans nécessiter d’instance de la classe GT.
Elle utilise l’API `Intl.DisplayNames` pour fournir les noms localisés des paramètres régionaux pour tout code de langue BCP-47 valide.

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

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

***


## Référence

### Paramètres

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

### Description des paramètres

| Paramètre       | Description                                                                                 |
| --------------- | ------------------------------------------------------------------------------------------- |
| `locale`        | Code de langue BCP-47 pour lequel obtenir le nom d’affichage                                |
| `defaultLocale` | Paramètre régional à utiliser pour localiser le nom d’affichage (par défaut : &#39;en&#39;) |
| `customMapping` | Mappage personnalisé facultatif pour les codes et noms de langue                            |

### Renvoie

`string` - Le nom d’affichage localisé associé au paramètre régional.

***

## Comportement

### Résolution de la langue d’affichage

La fonction localise les noms selon l’ordre de priorité suivant :

1. le paramètre `defaultLocale` (s’il est fourni)
2. le paramètre régional par défaut de la bibliothèque (&#39;en&#39;)

### Intégration d’un mappage personnalisé

* Les mappages personnalisés sont vérifiés en priorité pour les codes de langue et les noms
* Prend en charge la résolution des alias et les noms d’affichage personnalisés
* Utilise `Intl.DisplayNames` standard comme solution de repli pour les codes non mappés

### Stratégie de résolution des noms

1. **Nom de mappage personnalisé** (priorité maximale)
2. **Intl.DisplayNames** dans le paramètre régional par défaut
3. **Intl.DisplayNames** dans le paramètre régional par défaut de la bibliothèque (&#39;en&#39;)
4. **Code de langue lui-même** (solution de repli)

***

## Exemples

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

// Noms d'affichage en anglais
console.log(getLocaleName('es', 'en')); // "Spanish (Spain)"
console.log(getLocaleName('ja', 'en')); // "Japanese (Japan)"
console.log(getLocaleName('zh', 'en')); // "Chinese (China)"
```


### Création des options de paramètres régionaux

```typescript
import { getLocaleName, getLocaleEmoji } from 'generaltranslation';

function buildLocaleOptions(
  supportedLocales: string[],
  displayLocale: string = 'en'
) {
  return supportedLocales.map(locale => ({
    value: locale,
    label: getLocaleName(locale, displayLocale),
    emoji: getLocaleEmoji(locale)
  }));
}

const options = buildLocaleOptions([
  'en',
  'es',
  'fr',
  'de',
  'ja'
], 'en');

console.log(options);
// [
//   { value: 'en', label: 'English (United States)', emoji: '🇺🇸' },
//   { value: 'es', label: 'Spanish (Spain)', emoji: '🇪🇸' },
//   ...
// ]
```

***


## Remarques

* Les mappages personnalisés priment sur les `Intl.DisplayNames` standard
* Renvoie le code de langue lui-même si aucun nom d’affichage ne peut être déterminé
* Le paramètre régional d’affichage détermine la langue du nom renvoyé

## Étapes suivantes

* Récupérez l’emoji du paramètre régional avec [`getLocaleEmoji`](/docs/core/functions/locales/get-locale-emoji)
* Utilisez la méthode de classe GT pour les opérations avec état [`getLocaleName`](/docs/core/class/methods/locales/get-locale-name)
* Découvrez le type [`CustomMapping`](/docs/core/types/custom-mapping)