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

## Descripción general

La función autónoma `getLocaleEmoji` obtiene una bandera emoji o un símbolo para un código de configuración regional sin necesidad de una instancia de la clase GT.
Devuelve los emojis de bandera correspondientes para países y territorios según la región de la configuración regional, y admite asignaciones de emojis personalizadas.

```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.)
```

***


## Referencia

### Parámetros

<TypeTable
  type={{
  "locale": {
    type: 'string',
    optional: false,
  },
  "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 obtener el emoji correspondiente                      |
| `customMapping` | Asignación personalizada opcional para códigos de configuración regional y sobrescrituras de emoji |

### Devuelve

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

* Emoji de bandera de país o territorio para configuraciones regionales con región (p. ej., `🇺🇸`, `🇫🇷`, `🇯🇵`)
* Emoji personalizado si está definido en el mapeo
* Emoji de bandera predeterminado (`🏳️`) para configuraciones regionales no reconocidas

***

## Ejemplos

### Obtención básica de emojis

```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 múltiples idiomas
console.log(getLocaleEmoji('en-CA')); // "🇨🇦"
console.log(getLocaleEmoji('fr-CA')); // "🇨🇦"
console.log(getLocaleEmoji('de-CH')); // "🇨🇭"
console.log(getLocaleEmoji('fr-CH')); // "🇨🇭"
```

***


## Notas

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

## Siguientes pasos

* Usa el método de la clase GT [`getLocaleEmoji`](/docs/core/class/methods/locales/get-locale-emoji)
* Obtén las propiedades de la configuración regional con [`getLocaleProperties`](/docs/core/functions/locales/get-locale-properties)
* Obtén los nombres de la configuración regional con [`getLocaleName`](/docs/core/functions/locales/get-locale-name)
* Valida configuraciones regionales con [`isValidLocale`](/docs/core/functions/locales/is-valid-locale)