# generaltranslation: General Translation Core SDK: getLocaleName
URL: https://generaltranslation.com/es/docs/core/class/methods/locales/get-locale-name.mdx
---
title: getLocaleName
description: Referencia de la API para el método getLocaleName de GT
---

## Resumen

El método `getLocaleName` obtiene el nombre de visualización de un código de configuración regional mediante la API `Intl.DisplayNames`.
Devuelve un nombre legible para cualquier código de configuración regional BCP-47 válido, localizado según la configuración regional de origen de la instancia.

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

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

***


## Referencia

### Parámetros

<TypeTable
  type={{
  "locale?": {
    type: 'cadena',
    optional: true,
    default: 'this.targetLocale',
  }
}}
/>

### Descripción de los parámetros

| Parámetro | Descripción                                                                                                                                            |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `locale`  | Código de configuración regional BCP-47 cuyo nombre de visualización se quiere obtener. Si no se proporciona, se usa el `targetLocale` de la instancia |

### Devuelve

`cadena` - El nombre de visualización localizado correspondiente a la configuración regional.

### Lanza

* `Error` - Si no se proporciona ninguna configuración regional y la instancia no tiene `targetLocale` configurado

***

## Comportamiento

### Idioma de visualización

El nombre de visualización se localiza según:

1. La `sourceLocale` de la instancia (si está configurada)
2. La configuración regional predeterminada de la biblioteca (`en`)

### Integración de asignación personalizada

* Primero se comprueban las asignaciones personalizadas de configuración regional
* Si se define un nombre personalizado, tiene prioridad
* Si no, recurre a `Intl.DisplayNames` para los códigos BCP-47 estándar

***

## Ejemplos

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

// Obtener el nombre para la configuración regional de destino
console.log(gt.getLocaleName()); // "French (France)"

// Obtener nombres para otras configuraciones regionales
console.log(gt.getLocaleName('es')); // "Spanish (Spain)"
console.log(gt.getLocaleName('de')); // "German (Germany)"
console.log(gt.getLocaleName('ja')); // "Japanese (Japan)"
```

***


## Notas

* El método usa el `sourceLocale` de la instancia para determinar el idioma que se muestra
* Los nombres de las asignaciones personalizadas tienen prioridad sobre los nombres estándar de Intl.DisplayNames

## Siguientes pasos

* Obtén el emoji de la configuración regional con [`getLocaleEmoji`](/docs/core/class/methods/locales/get-locale-emoji)
* Obtén información detallada de la configuración regional con [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties)
* [Más información sobre el tipo CustomMapping](/docs/core/types/custom-mapping)