# react-native: useLocale
URL: https://generaltranslation.com/ja/docs/react-native/api/helpers/use-locale.mdx
---
title: useLocale
description: useLocaleフックのAPIリファレンス
---

{/* 自動生成: 直接編集しないでください。代わりに、content/docs-templates/ 内のテンプレートを編集してください。 */}


## 概要

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

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

## リファレンス

### 戻り値

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

***

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

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

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

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

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

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

***

## 使用例

### 基本的な使い方

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

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

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

***


## 注意事項

* `useLocale` フックは、コンテキストにアクセスするために [`<GTProvider>`](/docs/react-native/api/components/gtprovider) を利用します。アプリのルートでプロバイダーが設定されていることを確認してください。
* `useLocale` はクライアントサイドでのみ使用できます。
* ロケールコードの詳細は[こちら](/docs/core/locales)を参照してください。

## 次のステップ

* [`gt.config.json`](/docs/react-native/api/config/gt-config-json) ファイルを使って、アプリケーションでサポート対象のロケールを管理・指定する方法を確認してください。