# gt-next: General Translation Next.js SDK: useLocale
URL: https://generaltranslation.com/ja/docs/next/api/helpers/use-locale.mdx
---
title: useLocale
description: useLocale フックの API リファレンス
---

{/* 自動生成: 直接編集せず、代わりに content/docs-templates/ 内の template を編集してください。 */}


## 概要

`useLocale` フックは、[`<GTProvider>` コンテキスト](/docs/next/api/components/gtprovider) から現在のユーザーのロケールを取得します。
ロケールは BCP 47 の [ロケールコード](/docs/core/locales) (例: `'en-US'`) として返されます。

<Callout>
  `useLocale` はクライアントサイドのフックであり、*クライアントサイドコンポーネントでのみ使用できます*。
  アプリが [`<GTProvider>`](/docs/next/api/components/gtprovider) でラップされていることを確認してください。
</Callout>

## リファレンス

### 戻り値

ユーザーの現在のロケールを表す文字列です (例: `'en-US'`) 。

***

## フォールバックの動作

サポートされていないロケールが要求された場合は、フォールバック先のロケールが選択されます。

たとえば、サポートされていないロケールが指定された場合でも、
(1) ユーザーがブラウザ設定で複数の優先ロケールを設定しており、
(2) そのいずれかのロケールがアプリケーションでサポートされている場合、
最も適した言語のロケールにフォールバックします。

また、フォールバック可能なロケールがない場合でも、
2 つのロケールが同じ言語を共有していれば (例: `en-US` と `en-GB`) 、
同じ言語のサポート済みロケールにフォールバックします。

どちらの条件も満たされない場合は、デフォルトロケールが使用されます。

サポートされるロケールの設定については、[`gt.config.json`](/docs/next/api/config/gt-config-json) のドキュメントを参照してください。

***

## 例

### 基本的な使い方

現在のロケールを取得し、コンポーネント内に表示します。

```jsx title="CurrentLocale.jsx" copy
'use client';
import { useLocale } from 'gt-next';

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

***


## 注意事項

* `useLocale` フックは、コンテキストへのアクセスに [`<GTProvider>`](/docs/next/api/components/gtprovider) を使用します。アプリのルートでプロバイダーでラップしておいてください。
* `useLocale` はクライアントサイドでのみ使用できます。
* ロケールコードの詳細は、[こちら](/docs/core/locales)を参照してください。

## 次のステップ

* [`gt.config.json`](/docs/next/api/config/gt-config-json) ファイルを使って、アプリケーションでサポートするロケールの管理方法と指定方法を学びましょう。