# gt-next: General Translation Next.js SDK: getLocaleProperties
URL: https://generaltranslation.com/ja/docs/next/api/helpers/get-locale-properties.mdx
---
title: getLocaleProperties
description: getLocaleProperties サーバーサイドメソッドの API リファレンス
---

## 概要

`getLocaleProperties` 関数は、サーバーサイドレンダリング時に、指定したロケールのメタデータ (名称、ネイティブ名、言語、リージョン、文字体系の情報など) を返します。

<Callout>
  `getLocaleProperties` はサーバーサイドメソッドのため、サーバーコンポーネントでのみ使用できます。
</Callout>

クライアントサイドで使用する場合は、[`useLocaleProperties`](/docs/next/api/helpers/use-locale-properties) を参照してください。

## リファレンス

### パラメータ

| パラメータ    | 型        | 説明                                      |
| -------- | -------- | --------------------------------------- |
| `locale` | `string` | BCP 47 のロケールコード (例: `'en-US'`、`'ja'`) 。 |

### 戻り値

次のフィールドを含む `LocaleProperties` オブジェクトを返します。

| フィールド                      | 型        | 説明                                      |
| -------------------------- | -------- | --------------------------------------- |
| `code`                     | `string` | ロケールコード (例: `'en-US'`) 。                |
| `name`                     | `string` | ロケールの英語名 (例: `'American English'`) 。    |
| `nativeName`               | `string` | ロケールの言語での名前 (例: `'American English'`) 。 |
| `languageCode`             | `string` | 言語サブタグ (例: `'en'`) 。                    |
| `languageName`             | `string` | 言語の英語名 (例: `'English'`) 。               |
| `nativeLanguageName`       | `string` | その言語での言語名 (例: `'English'`) 。            |
| `nameWithRegionCode`       | `string` | リージョンを含むロケール名 (例: `'English (US)'`) 。   |
| `nativeNameWithRegionCode` | `string` | リージョンを含む、ロケールの言語でのロケール名。                |
| `regionCode`               | `string` | リージョンサブタグ (例: `'US'`) 。                 |
| `regionName`               | `string` | リージョンの英語名 (例: `'United States'`) 。      |
| `nativeRegionName`         | `string` | ロケールの言語でのリージョン名。                        |
| `scriptCode`               | `string` | スクリプトサブタグ (例: `'Latn'`) 。               |
| `scriptName`               | `string` | スクリプトの英語名 (例: `'Latin'`) 。              |
| `nativeScriptName`         | `string` | ロケールの言語でのスクリプト名。                        |
| `maximizedCode`            | `string` | 完全に展開されたロケールコード (例: `'en-Latn-US'`) 。   |

***

## 例

### 基本的な使い方

```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>
  );
}
```

***


## 注記

* この関数は同期的に動作するため、`await`は不要です。
* ロケールセレクターの作成や、ロケールのメタデータをユーザーに表示する場合に役立ちます。

## 次のステップ

* クライアントでの対応については、[`useLocaleProperties`](/docs/next/api/helpers/use-locale-properties)を参照してください。
* [ロケールコード](/docs/core/locales)について詳しくは、こちらを参照してください。