# 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 autónoma getLocaleName
---

## Descripción general

La función autónoma `getLocaleName` obtiene el nombre para mostrar de un código de configuración regional sin requerir una instancia de la clase GT.
Usa la API `Intl.DisplayNames` para proporcionar 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); // "French (Canada)"
```

***


## 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 para el que se obtendrá el nombre para mostrar                        |
| `defaultLocale` | Configuración regional que se usará para localizar el nombre para mostrar (el valor predeterminado es `'en'`) |
| `customMapping` | mapeo personalizado opcional para códigos y nombres de configuración regional                                  |

### Devuelve

`cadena` - El nombre para mostrar localizado de la configuración regional.

***

## Comportamiento

### Resolución del idioma de visualización

La función localiza 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 de mapeo personalizado

* Los mapeos personalizados se consultan primero, tanto para los códigos de configuración regional como para los nombres
* Admite la resolución de alias y nombres para mostrar personalizados
* Recurre a `Intl.DisplayNames` estándar para los códigos no mapeados

### Estrategia de resolución de nombres

1. **Nombre de mapeo personalizado** (máxima prioridad)
2. **Intl.DisplayNames** en la configuración regional predeterminada
3. **Intl.DisplayNames** en la configuración regional predeterminada de la biblioteca (&#39;en&#39;)
4. **El propio código de configuración regional** (respaldo)

***

## 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

* Los mapeos personalizados tienen prioridad sobre el `Intl.DisplayNames` estándar
* Devuelve el propio código de configuración regional si no se puede determinar ningún nombre para mostrar
* El parámetro de configuración regional de visualización determina en qué idioma se devuelve el nombre

## 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)