# General Translation React SDKs (gt-react, gt-next): useLocale
URL: https://generaltranslation.com/fr/docs/react/reference/hooks/use-locale.mdx
---
title: useLocale
description: Obtenez le paramètre régional actif avec General Translation gt-react. Référence d’API pour useLocale.

---

Le hook `useLocale` renvoie le paramètre régional actuel de l’utilisateur depuis le contexte [`<GTProvider>`](/docs/react/reference/components/gt-provider), sous la forme d’un code de langue BCP 47 tel que `en-US`.

*Disponible dans `gt-react`, `gt-next`, `gt-tanstack-start` et `gt-react-native`. Les exemples importent depuis `gt-react` ; importez plutôt depuis le package de votre framework.*

## Aperçu [#overview]

Utilisez `useLocale` pour obtenir le paramètre régional actif.

```tsx
import { useLocale } from 'gt-react';

export default function CurrentLocale() {
  const locale = useLocale(); // [!code highlight]
  return <p>Current locale: {locale}</p>;
}
```

*Remarque : dans `gt-react`, appelez `useLocale` au sein d’un [`<GTProvider>`](/docs/react/reference/components/gt-provider). Dans `gt-next`, cela fonctionne aussi dans les composants serveur synchrones.*

## Comment ça fonctionne [#how-it-works]

Lorsqu’un paramètre régional non pris en charge est demandé, un contenu de secours est sélectionné :

* Si l’utilisateur a configuré plusieurs paramètres régionaux préférés dans son navigateur et que l’un d’eux est pris en charge, la langue prise en charge la plus adaptée est utilisée.
* Sinon, si deux paramètres régionaux correspondent à la même langue (par exemple, `en-US` et `en-GB`), le paramètre régional pris en charge correspondant à cette langue est utilisé.
* Si aucun de ces cas ne s’applique, le [paramètre régional par défaut](/docs/react/reference/config#default-locale) est utilisé.

## Renvoie [#returns]

**Type** `string`

Le paramètre régional actuel de l’utilisateur, par exemple `en-US`.

## Remarques [#notes]

* Dans un composant App Router asynchrone, utilisez plutôt [`getLocale`](/docs/react/nextjs/reference/functions/get-locale).
* Pour modifier le paramètre régional, utilisez [`useSetLocale`](/docs/react/reference/hooks/use-set-locale) ; pour consulter le paramètre régional source, utilisez [`useDefaultLocale`](/docs/react/reference/hooks/use-default-locale).