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

## Descripción general

El método `getLocaleProperties` obtiene todas las propiedades de un código de configuración regional y proporciona
información detallada, incluidos nombres de visualización, códigos de región, información del sistema de escritura y banderas emoji.
Devuelve un objeto `LocaleProperties` completo con todos los datos necesarios para crear interfaces de usuario internacionalizadas avanzadas.

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

const props = gt.getLocaleProperties('fr-CA');
console.log(props.name); // "French (Canada)"
console.log(props.nativeName); // "français (Canada)"
console.log(props.emoji); // "🇨🇦"
```

***


## 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 obtendrán las propiedades. Si no se proporciona, se usa el `targetLocale` de la instancia |

### Devuelve

`LocaleProperties` - Un objeto completo que contiene toda la información de la configuración regional:

* `code`: Código de configuración regional estandarizado
* `name`: Nombre de visualización en la configuración regional de origen
* `nativeName`: Nombre de visualización en la propia configuración regional
* `languageCode`, `languageName`, `nativeLanguageName`: Información del idioma
* `regionCode`, `regionName`, `nativeRegionName`: Información de la región
* `scriptCode`, `scriptName`, `nativeScriptName`: Información del sistema de escritura
* `maximizedCode`, `minimizedCode`: Formas canónicas
* `nameWithRegionCode`, `nativeNameWithRegionCode`: Formatos de visualización combinados
* `emoji`: Bandera o emoji representativo

### Lanza

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

***

## Ejemplos

### Uso básico

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

// Obtener propiedades para la configuración regional de destino
const props = gt.getLocaleProperties();
console.log(props.name); // "French (France)"
console.log(props.nativeName); // "français (France)"
console.log(props.languageCode); // "fr"
console.log(props.regionCode); // "FR"
console.log(props.emoji); // "🇫🇷"

// Obtener propiedades para otras configuraciones regionales
const germanProps = gt.getLocaleProperties('de-AT');
console.log(germanProps.name); // "Austrian German"
console.log(germanProps.nativeName); // "Österreichisches Deutsch"
console.log(germanProps.regionName); // "Austria"
console.log(germanProps.nativeRegionName); // "Österreich"
```

***


## Notas

* Todos los nombres de visualización visibles siguen la configuración `sourceLocale` de la instancia
* Las propiedades de mapeo personalizadas prevalecen sobre las API estándar de Intl

## Próximos pasos

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