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

## Descripción general

El método `determineLocale` determina la configuración regional que mejor se ajusta a las preferencias del usuario a partir de una lista de configuraciones regionales aprobadas.
Implementa la negociación de configuraciones regionales para encontrar la configuración regional más adecuada cuando no hay coincidencias exactas disponibles.

```typescript
const gt = new GT({
  sourceLocale: 'en-US',
  locales: ['en-US', 'es-ES', 'fr-FR', 'de-DE']
});

// Coincidencia exacta
console.log(gt.determineLocale('en-US')); // 'en-US'

// Alternativa por idioma
console.log(gt.determineLocale('en-GB')); // 'en-US' (variante de inglés más cercana)

// Múltiples preferencias
console.log(gt.determineLocale(['fr-CA', 'es-MX', 'en-US'])); // 'es-ES' (español más cercano)

// Sin coincidencia
console.log(gt.determineLocale('it-IT')); // undefined
```

***


## Referencia

### Parámetros

<TypeTable
  type={{
  "locales": {
    type: 'string | string[]',
    optional: false,
  },
  "approvedLocales?": {
    type: 'string[]',
    optional: true,
    default: 'this.locales'
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
    default: 'this.customMapping'
  }
}}
/>

### Devuelve

`cadena | undefined` - La configuración regional que mejor coincide, o `undefined` si no se encuentra ninguna coincidencia

***

## Ejemplos

### Negociación de la configuración regional del usuario

```typescript
const gt = new GT({
  sourceLocale: 'en-US',
  locales: ['en-US', 'en-GB', 'es-ES', 'fr-FR']
});

// Simular el encabezado Accept-Language del navegador
const userPreferences = ['fr-CA', 'en-GB', 'en'];
const bestMatch = gt.determineLocale(userPreferences);
console.log(bestMatch); // 'fr-FR' según el orden de preferencia

```

***


## Notas

* Devuelve la primera coincidencia exacta entre las configuraciones regionales aprobadas
* Si la región exacta no está disponible, recurre a coincidencias por idioma
* Respeta el orden de preferencia del array de entrada
* Devuelve undefined cuando no se encuentra ninguna coincidencia adecuada
* Es esencial para implementar la negociación de configuración regional en aplicaciones web

## Siguientes pasos

* Verifica si se necesita traducción con [`requires-translation`](/docs/core/class/methods/locales/requires-translation)
* Compara idiomas con [`is-same-language`](/docs/core/class/methods/locales/is-same-language)