# gt-next: General Translation Next.js SDK: getLocale
URL: https://generaltranslation.com/fr/docs/next/api/helpers/get-locale.mdx
---
title: getLocale
description: Référence API de la méthode getLocale côté serveur
---

## Vue d’ensemble

La fonction `getLocale` récupère le paramètre régional actuel de l’utilisateur lors du rendu côté serveur.
Le paramètre régional est renvoyé sous la forme d’un [code de langue](/docs/core/locales) BCP 47, par exemple `'en-US'`.

<Callout>
  `getLocale` est une méthode côté serveur et ne peut être utilisée que dans des
  composants côté serveur.
</Callout>

Pour une utilisation côté client, consultez [`useLocale`](/docs/next/api/helpers/use-locale).

## Référence

### Retourne

Une promesse qui se résout en une chaîne correspondant au paramètre régional actuel de l’utilisateur, par exemple `'en-US'`.

***

## Comportement de repli

Lorsqu’un paramètre régional non pris en charge est demandé, un paramètre régional de repli est sélectionné.

Par exemple, dans le cas d’un paramètre régional non pris en charge,
si (1) l’utilisateur a configuré plusieurs paramètres régionaux préférés dans les paramètres de son navigateur,
et (2) l’un de ces paramètres régionaux est pris en charge par votre application,
alors le paramètre régional basculera vers la langue la plus appropriée.

De plus, si aucun paramètre régional de repli n’est disponible,
mais que deux paramètres régionaux partagent la même langue (par ex. `en-US` et `en-GB`),
alors le paramètre régional basculera vers le paramètre régional pris en charge qui partage cette même langue.

Si aucune de ces deux conditions n’est remplie, le paramètre régional par défaut sera utilisé.

Consultez la documentation de [`gt.config.json`](/docs/next/api/config/gt-config-json) pour savoir comment configurer les paramètres régionaux pris en charge.

***

## Exemples

### Utilisation de base

Récupérez le paramètre régional de l’utilisateur lors du rendu côté serveur.

```javascript title="GetUserLocale.jsx" copy
import { getLocale } from 'gt-next/server';

export default async function GetUserLocale() {
  const locale = await getLocale(); // [!code highlight]
  return <p>User locale: {locale}</p>;
}
```

***


## Remarques

* La fonction `getLocale` est asynchrone et doit être utilisée avec `await` pour récupérer le paramètre régional.
* Elle est conçue spécifiquement pour une utilisation côté serveur. Consultez [`useLocale`](/docs/next/api/helpers/use-locale) pour les composants côté client.
* Le paramètre régional renvoyé est conforme au format du [code de langue](/docs/core/locales).

## Étapes suivantes

* Découvrez comment configurer les paramètres régionaux pris en charge avec [withGTConfig()](/docs/next/api/config/with-gt-config).