# generaltranslation: General Translation Core SDK: getLocaleEmoji
URL: https://generaltranslation.com/es/docs/core/class/methods/locales/get-locale-emoji.mdx
---
title: getLocaleEmoji
description: Referencia de API del método getLocaleEmoji de GT
---

## Resumen

El método `getLocaleEmoji` obtiene un emoji de bandera o un símbolo para un código de Configuración regional según su región.
Devuelve los emojis de bandera correspondientes para países y territorios, con alternativas para idiomas sin una región específica y compatibilidad con emojis personalizados mediante asignaciones.

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

const emoji = gt.getLocaleEmoji('fr-CA');
console.log(emoji); // "🇨🇦" (bandera canadiense)

const usEmoji = gt.getLocaleEmoji('en-US');
console.log(usEmoji); // "🇺🇸" (bandera de EE. UU.)

const enEmoji = gt.getLocaleEmoji('en');
console.log(enEmoji); // "🇺🇸" (bandera de EE. UU.)
```

***


## Referencia

### Parámetros

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

### Descripción de los parámetros

| Parámetro | Descripción                                                                                                                          |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `locale`  | Código de Configuración regional BCP-47 para el que se obtiene el emoji. Si no se proporciona, se usa `targetLocale` de la instancia |

### Devuelve

`cadena` - Emoji de bandera o símbolo que representa la Configuración regional:

* Emoji de bandera de país o territorio para las configuraciones regionales que incluyen región (p. ej., `🇺🇸`, `🇫🇷`, `🇯🇵`)
* Emoji específico del idioma para algunos idiomas sin región
* Emoji de bandera predeterminado (`🏳️`) para configuraciones regionales no reconocidas

### Lanza

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

***

## Ejemplos

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

// Obtener emoji para la Configuración regional de destino
console.log(gt.getLocaleEmoji()); // "🇪🇸" (usa targetLocale 'es')

// Obtener emojis para diferentes configuraciones regionales
console.log(gt.getLocaleEmoji('en-US')); // "🇺🇸"
console.log(gt.getLocaleEmoji('fr-FR')); // "🇫🇷"
console.log(gt.getLocaleEmoji('de-DE')); // "🇩🇪"
console.log(gt.getLocaleEmoji('ja-JP')); // "🇯🇵"
console.log(gt.getLocaleEmoji('zh-CN')); // "🇨🇳"
```

***


## Notas

* Devuelve emojis de banderas según el código de región de la configuración regional, cuando está disponible
* Los emojis de asignación personalizada tienen prioridad sobre la selección basada en la región
* Usa símbolos indicadores regionales de Unicode para generar banderas
* Usa `🏳️` (bandera blanca) de forma predeterminada para configuraciones regionales no reconocidas o no válidas
* Compatible con todos los navegadores modernos y sistemas operativos que admiten emojis Unicode

## Próximos pasos

* Obtén las propiedades de la configuración regional con [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties)
* Obtén los nombres de las configuraciones regionales con [`getLocaleName`](/docs/core/class/methods/locales/get-locale-name)
* Valida las configuraciones regionales con [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)
* [Más información sobre el tipo `CustomMapping`](/docs/core/types/custom-mapping)