# generaltranslation: General Translation Core SDK: resolveAliasLocale
URL: https://generaltranslation.com/fr/docs/core/functions/locales/resolve-alias-locale.mdx
---
title: resolveAliasLocale
description: Référence d’API pour la fonction resolveAliasLocale
---

## Vue d’ensemble

La fonction `resolveAliasLocale` reconvertit les codes de langue de paramètres régionaux canoniques en codes d’alias de paramètre régional lorsqu’un mappage personnalisé est configuré. Cette fonction autonome offre le même comportement que la méthode de classe GT, sans nécessiter d’instance.

***

## Référence

### Paramètres

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

### Retourne

`string` - Le code de langue de l’alias de paramètre régional si un mappage existe ; sinon, le paramètre régional d’origine

***

## Exemples

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

const customMapping = {
  'simplified-chinese': { code: 'zh-CN', name: 'Simplified Chinese' },
  'traditional-chinese': { code: 'zh-TW', name: 'Traditional Chinese' }
};

// Résoudre le paramètre régional canonique en alias
console.log(resolveAliasLocale('zh-CN', customMapping)); // 'simplified-chinese'
console.log(resolveAliasLocale('zh-TW', customMapping)); // 'traditional-chinese'

// Un paramètre régional sans correspondance retourne l'original
console.log(resolveAliasLocale('es-ES', customMapping)); // 'es-ES'
```

***


## Remarques

* Reconvertit les codes de langue de paramètres régionaux canoniques en alias plus conviviaux
* Renvoie le paramètre régional d’origine si aucun mappage n’existe
* Indispensable pour afficher des noms de paramètres régionaux destinés aux utilisateurs
* Fonctionne avec des mappages de paramètres régionaux personnalisés
* Fonction sans état - aucun effet de bord

## Prochaines étapes

* Utilisez la méthode de classe GT [`resolveAliasLocale`](/docs/core/class/methods/locales/resolve-alias-locale)
* Convertissez en format canonique avec [`resolveCanonicalLocale`](/docs/core/class/methods/locales/resolve-canonical-locale)