# generaltranslation: General Translation Core SDK: determineLocale
URL: https://generaltranslation.com/fr/docs/core/functions/locales/determine-locale.mdx
---
title: determineLocale
description: Référence API de la fonction determineLocale
---

## Vue d’ensemble

La fonction `determineLocale` détermine le paramètre régional le plus adapté parmi les paramètres régionaux approuvés en fonction des préférences de l’utilisateur, sans nécessiter d’instance de la classe GT.

***

## Référence

### Paramètres

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

### Renvoie

`string | undefined` - Paramètre régional le plus adapté, ou undefined s&#39;il n&#39;y a aucune correspondance

***

## Exemples

### Négociation de contenu

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

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

// Correspondance exacte
console.log(determineLocale('en-US', approvedLocales)); // 'en-US'

// Repli sur la langue
console.log(determineLocale('en-GB', approvedLocales)); // 'en-US'

// Préférences multiples
console.log(determineLocale(['fr-CA', 'es-MX'], approvedLocales)); // 'es-ES'

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

***


## Remarques

* Implémente une négociation intelligente des paramètres régionaux
* Renvoie la première correspondance exacte ou linguistique de la liste approuvée
* Respecte l’ordre de préférence du tableau d’entrée
* Renvoie `undefined` lorsqu’aucune correspondance n’est trouvée
* Indispensable pour la négociation des paramètres régionaux dans les applications web

## Prochaines étapes

* Utilisez la méthode de classe GT [`determineLocale`](/docs/core/class/methods/locales/determine-locale)
* Vérifiez si une traduction est nécessaire avec [`requiresTranslation`](/docs/core/functions/locales/requires-translation)