# General Translation Platform: getLocaleEmoji
URL: https://generaltranslation.com/es/docs/platform/core/reference/utility-functions/locales/get-locale-emoji.mdx
---

title: getLocaleEmoji
description: Devuelve un emoji identificador para una configuración regional o una región sin una instancia de GT. Referencia de la API de getLocaleEmoji.

---

[`getLocaleEmoji`](/docs/platform/core/reference/gt-class-methods/locales/get-locale-emoji) es una función de utilidad independiente de la biblioteca Core de General Translation que devuelve una bandera emoji o un símbolo para un código de configuración regional. Selecciona una bandera de país o territorio según la región de la configuración regional y admite mapeos de emoji personalizados.

## Resumen [#overview]

Importa `getLocaleEmoji` directamente desde `generaltranslation` y llámalo con un código de configuración regional. No requiere una clave de API ni una instancia de [GT](/docs/platform/core/reference/gt-class/constructor). Para usar la versión equivalente basada en instancias, utiliza en su lugar el método [`getLocaleEmoji`](/docs/platform/core/reference/gt-class-methods/locales/get-locale-emoji) en una instancia de [`GT`](/docs/platform/core/reference/gt-class/constructor).

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

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

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

Firma:

```typescript
getLocaleEmoji(locale: string, customMapping?: CustomMapping): string
```

## Cómo funciona [#how-it-works]

* **Selección basada en la región.** Usa la región de la configuración regional (cuando está presente) para seleccionar un emoji de bandera con los símbolos indicadores regionales de Unicode. Recurre a emojis predeterminados para ciertos idiomas.
* **Prioridad del mapeo personalizado.** Los emojis definidos en un [`customMapping`](/docs/platform/core/reference/types/custom-mapping) tienen prioridad sobre la selección basada en la región.
* **Contenido alternativo.** Devuelve un emoji de globo predeterminado (`🌍`) para configuraciones regionales no reconocidas.

## Parámetros [#parameters]

| Parámetro                          | Descripción                                                                        | Tipo                                                                  | Opcional | Predeterminado |
| ---------------------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------- | -------- | -------------- |
| [`locale`](#locale)                | Código de configuración regional BCP-47 del que se obtendrá el emoji.              | `string`                                                              | No       | —              |
| [`customMapping`](#custom-mapping) | Mapeo personalizado para códigos de configuración regional y anulaciones de emoji. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sí       | —              |

### `locale` [#locale]

**Tipo** `string` · **obligatorio**

El código de configuración regional BCP-47 del que se quiere obtener el emoji.

### `customMapping` [#custom-mapping]

**Tipo** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **Opcional**

Un mapeo personalizado opcional para los códigos de configuración regional y las anulaciones de emoji.

## Devuelve [#returns]

**Tipo** `string`

Un emoji de bandera o un símbolo que representa la configuración regional:

* Un emoji de bandera de país o territorio para configuraciones regionales con región (por ejemplo, `🇺🇸`, `🇫🇷`, `🇯🇵`).
* Un emoji personalizado, si está definido en el mapeo.
* El emoji de globo predeterminado (`🌍`) para configuraciones regionales no reconocidas.

## Ejemplos [#examples]

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

// Banderas de países comunes
console.log(getLocaleEmoji('en-US')); // "🇺🇸"
console.log(getLocaleEmoji('fr-FR')); // "🇫🇷"
console.log(getLocaleEmoji('de-DE')); // "🇩🇪"
console.log(getLocaleEmoji('ja-JP')); // "🇯🇵"
console.log(getLocaleEmoji('zh-CN')); // "🇨🇳"

// Regiones con varios idiomas
console.log(getLocaleEmoji('en-CA')); // "🇨🇦"
console.log(getLocaleEmoji('fr-CA')); // "🇨🇦"
console.log(getLocaleEmoji('de-CH')); // "🇨🇭"
console.log(getLocaleEmoji('fr-CH')); // "🇨🇭"
```

## Notas [#notes]

* Devuelve emojis de banderas mediante símbolos indicadores regionales de Unicode.
* Los emojis del mapeo personalizado tienen prioridad sobre la selección basada en la región.
* Admite todos los códigos de región ISO 3166-1 alpha-2 para ofrecer una cobertura completa.