# General Translation React SDKs (gt-react, gt-next, gt-react-native): getLocale
URL: https://generaltranslation.com/fr/docs/react/tanstack-start/reference/functions/get-locale.mdx
---

title: getLocale
description: Consultez le paramètre régional d’exécution TanStack Start en cours avec General Translation. Référence de l’API getLocale.

---

La fonction `getLocale` renvoie le paramètre régional associé à la requête serveur en cours ou au navigateur sous la forme d’un code de langue BCP 47. Importez-la depuis `gt-tanstack-start`.

## Vue d’ensemble [#overview]

```ts
import { getLocale } from 'gt-tanstack-start';

const locale = getLocale(); // 'en-US'
```

```ts
getLocale(): string
```

## Fonctionnement [#how-it-works]

Sur le serveur, `getLocale` lit la valeur de paramètre régional propre à la requête créée par [`gtMiddleware`](/docs/react/tanstack-start/reference/functions/gt-middleware). Lorsque `localeRouting` est activé, le middleware résout le paramètre régional à partir du préfixe du chemin, puis du cookie de paramètre régional, de l’en-tête `Accept-Language` et de `defaultLocale`. Sans routage par paramètre régional, la résolution commence par le cookie.

Dans le navigateur, il lit le store de conditions initialisé par [`initializeGT`](/docs/react/reference/config#initialize). La fonction est synchrone. Les appels côté serveur lèvent une exception en dehors d’un contexte de requête middleware actif.

<Callout type="info">
  **Modifié dans la v11 :** utilisez `getLocale()` au lieu de `parseLocale()`, désormais obsolète, et importez les utilitaires d’exécution depuis `gt-tanstack-start` plutôt que depuis `gt-tanstack-start/server`.
</Callout>

## Renvoie [#returns]

**Type** `string`

Le paramètre régional de la requête en cours.

## Exemple [#example]

```ts
import { createServerFn } from '@tanstack/react-start';
import { getLocale } from 'gt-tanstack-start';

export const loadLocale = createServerFn({ method: 'GET' }).handler(() => {
  return getLocale();
});
```