# generaltranslation: General Translation Core SDK: getLocaleName
URL: https://generaltranslation.com/es/docs/core/functions/locales/get-locale-name.mdx
---
title: getLocaleName
description: Referencia de la API para la función independiente getLocaleName
---

## Resumen

La función independiente `getLocaleName` obtiene el nombre de visualización de un código de configuración regional sin requerir una instancia de la clase GT.
Usa la API `Intl.DisplayNames` para ofrecer nombres localizados de configuraciones regionales para cualquier código de configuración regional BCP-47 válido.

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

const name = getLocaleName('fr-CA', 'en');
console.log(name); // "francés (Canadá)"
```

***


## Referencia

### Parámetros

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

### Descripción de los parámetros

| Parámetro       | Descripción                                                                                                       |
| --------------- | ----------------------------------------------------------------------------------------------------------------- |
| `locale`        | Código de configuración regional BCP-47 del que se obtendrá el nombre de visualización                            |
| `defaultLocale` | Configuración regional que se usará para localizar el nombre de visualización (el valor predeterminado es `'en'`) |
| `customMapping` | Asignación personalizada opcional para los códigos y nombres de configuración regional                            |

### Devuelve

`string` - El nombre de visualización localizado de la configuración regional.

***

## Comportamiento

### Determinación del idioma de visualización

La función traduce los nombres según esta prioridad:

1. Parámetro `defaultLocale` (si se proporciona)
2. Configuración regional predeterminada de la biblioteca (&#39;en&#39;)

### Integración con asignación personalizada

* Las asignaciones personalizadas se comprueban primero, tanto para los códigos de configuración regional como para sus nombres
* Admite la resolución de alias y nombres de visualización personalizados
* Recurre a `Intl.DisplayNames` estándar para los códigos sin asignación personalizada

### Estrategia de resolución de nombres

1. **Nombre de asignación personalizada** (máxima prioridad)
2. **Intl.DisplayNames** en la configuración regional predeterminada
3. **Intl.DisplayNames** en la configuración predeterminada de la biblioteca (&#39;en&#39;)
4. **El código de configuración regional en sí** (alternativa)

***

## Ejemplos

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

// Nombres de visualización en inglés
console.log(getLocaleName('es', 'en')); // "Spanish (Spain)"
console.log(getLocaleName('ja', 'en')); // "Japanese (Japan)"
console.log(getLocaleName('zh', 'en')); // "Chinese (China)"
```


### Creación de opciones de configuración regional

```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: '🇪🇸' },
//   ...
// ]
```

***


## Notas

* Las asignaciones personalizadas tienen prioridad sobre `Intl.DisplayNames` estándar
* Devuelve el propio código de configuración regional si no se puede determinar ningún nombre de visualización
* El parámetro de configuración regional de visualización determina el idioma del nombre que se devuelve

## Próximos pasos

* Obtén el emoji de la configuración regional con [`getLocaleEmoji`](/docs/core/functions/locales/get-locale-emoji)
* Usa el método de la clase GT para operaciones con estado [`getLocaleName`](/docs/core/class/methods/locales/get-locale-name)
* Más información sobre el [tipo `CustomMapping`](/docs/core/types/custom-mapping)