# generaltranslation: General Translation Core SDK: determineLocale
URL: https://generaltranslation.com/es/docs/core/functions/locales/determine-locale.mdx
---
title: determineLocale
description: Referencia de la API de la función determineLocale
---

## Resumen

La función `determineLocale` determina la configuración regional que mejor coincida entre las configuraciones regionales aprobadas según las preferencias del usuario, sin necesidad de una instancia de la clase GT.

***

## Referencia

### Parámetros

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

### Devuelve

`string | undefined` - La configuración regional que mejor coincida, o `undefined` si no hay ninguna coincidencia

***

## Ejemplos

### Negociación de contenido

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

const approvedLocales = ['en-US', 'es-ES', 'fr-FR', 'de-DE'];

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

// Alternativa de idioma
console.log(determineLocale('en-GB', approvedLocales)); // 'en-US'

// Múltiples preferencias
console.log(determineLocale(['fr-CA', 'es-MX'], approvedLocales)); // 'es-ES'

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

***


## Notas

* Implementa una negociación inteligente de la configuración regional
* Devuelve la primera coincidencia exacta o de idioma de la lista aprobada
* Respeta el orden de preferencia en el array de entrada
* Devuelve undefined cuando no se encuentra ninguna coincidencia
* Esencial para la negociación de la configuración regional en aplicaciones web

## Siguientes pasos

* Usa el método de la clase GT [`determineLocale`](/docs/core/class/methods/locales/determine-locale)
* Comprueba si se necesita traducción con [`requiresTranslation`](/docs/core/functions/locales/requires-translation)