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

## Vue d’ensemble

La fonction `getLocaleProperties` renvoie des métadonnées sur un paramètre régional donné lors du rendu côté serveur, notamment son nom, son nom dans la langue locale, sa langue, sa région et les informations sur son système d’écriture.

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

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

## Référence

### Paramètres

| Paramètre | Type     | Description                                                       |
| --------- | -------- | ----------------------------------------------------------------- |
| `locale`  | `string` | Un code de langue BCP 47 (par ex. `'en-US'`, `'ja'`). |

### Valeurs de retour

Un objet `LocaleProperties` avec les champs suivants :

| Champ                      | Type     | Description                                                                        |
| -------------------------- | -------- | ---------------------------------------------------------------------------------- |
| `code`                     | `string` | Le code de langue (par ex. `'en-US'`).                                             |
| `name`                     | `string` | Le nom anglais du paramètre régional (par ex. `'American English'`).               |
| `nativeName`               | `string` | Le nom du paramètre régional dans sa propre langue (par ex. `'American English'`). |
| `languageCode`             | `string` | La sous-étiquette de langue (par ex. `'en'`).                                      |
| `languageName`             | `string` | Le nom anglais de la langue (par ex. `'English'`).                                 |
| `nativeLanguageName`       | `string` | Le nom de la langue dans sa propre langue (par ex. `'English'`).                   |
| `nameWithRegionCode`       | `string` | Le nom du paramètre régional, région incluse (par ex. `'English (US)'`).           |
| `nativeNameWithRegionCode` | `string` | Le nom natif du paramètre régional, région incluse.                                |
| `regionCode`               | `string` | La sous-étiquette de région (par ex. `'US'`).                                      |
| `regionName`               | `string` | Le nom anglais de la région (par ex. `'United States'`).                           |
| `nativeRegionName`         | `string` | Le nom de la région dans la langue du paramètre régional.                          |
| `scriptCode`               | `string` | La sous-étiquette d’écriture (par ex. `'Latn'`).                                   |
| `scriptName`               | `string` | Le nom anglais du système d’écriture (par ex. `'Latin'`).                          |
| `nativeScriptName`         | `string` | Le nom du système d’écriture dans la langue du paramètre régional.                 |
| `maximizedCode`            | `string` | Le code de langue entièrement développé (par ex. `'en-Latn-US'`).                  |

***

## Exemples

### Utilisation de base

```jsx title="LocaleInfo.jsx" copy
import { getLocaleProperties } from 'gt-next/server';

export default function LocaleInfo() {
  const props = getLocaleProperties('en-US'); // [!code highlight]
  return (
    <div>
      <p>Name: {props.name}</p>
      <p>Native name: {props.nativeName}</p>
      <p>Region: {props.regionName}</p>
    </div>
  );
}
```

***


## Remarques

* Cette fonction est synchrone — il n’est pas nécessaire de l’attendre.
* Utile pour créer des sélecteurs de paramètres régionaux ou afficher aux utilisateurs les métadonnées des paramètres régionaux.

## Étapes suivantes

* Consultez [`useLocaleProperties`](/docs/next/api/helpers/use-locale-properties) pour son équivalent côté client.
* Pour en savoir plus, consultez les [codes de langue](/docs/core/locales).