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

## 概要

`getLocales` 関数は、サーバーサイドレンダリング時にアプリケーションで設定されている対応ロケールの一覧を取得します。

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

クライアント側で使用するには、[`useLocales`](/docs/next/api/helpers/use-locales) を参照してください。

## リファレンス

### 戻り値

`string[]` — サポートされているロケールを表すBCP 47の[ロケールコード](/docs/core/locales)の配列。例: `['en-US', 'fr', 'ja']`。

***

## 例

### 基本的な使い方

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

export default function LocaleList() {
  const locales = getLocales(); // [!code highlight]
  return (
    <ul>
      {locales.map((locale) => (
        <li key={locale}>{locale}</li>
      ))}
    </ul>
  );
}
```

***


## 注記

* サポート対象のロケールは、[`gt.config.json`](/docs/next/api/config/gt-config-json) ファイルで設定します。
* `getLocales` はサーバーサイドでのみ使用できます。クライアントコンポーネントでは、[`useLocales`](/docs/next/api/helpers/use-locales) を使用してください。

## 次のステップ

* [`gt.config.json`](/docs/next/api/config/gt-config-json) でサポートするロケールを設定する方法を確認してください。
* クライアント側での対応機能については、[`useLocales`](/docs/next/api/helpers/use-locales) を参照してください。