# gt-react: General Translation React SDK: useDefaultLocale
URL: https://generaltranslation.com/ja/docs/react/api/helpers/use-default-locale.mdx
---
title: useDefaultLocale
description: useDefaultLocale HookのAPIリファレンス
---

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


## 概要

`useDefaultLocale` Hook は、[`<GTProvider>` コンテキスト](/docs/react/api/components/gtprovider) からアプリケーションのデフォルトロケールを取得します。
このロケールはアプリのフォールバック言語を表し、通常はユーザーの優先ロケールが利用できない場合に使われます。

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

設定については [`gt.config.json`](/docs/react/api/config/gt-config-json) を参照してください。
デフォルトロケールが指定されていない場合は、`'en-US'` が使用されます。

## リファレンス

### 戻り値

アプリケーションのデフォルトロケールを表す文字列。たとえば `'en-US'`。

***

## 例

### 基本的な使い方

アプリケーションのデフォルトロケールを取得し、コンポーネント内に表示します。

```jsx title="DefaultLocale.jsx" copy
'use client';
import { useDefaultLocale } from 'gt-react';

export default function DefaultLocale() {
  const defaultLocale = useDefaultLocale(); // [!code highlight]

  return <p>Default locale: {defaultLocale}</p>; // デフォルトロケールを表示する
}
```

***


## 注意事項

* `useDefaultLocale` Hook は、コンテキストにアクセスするために [`<GTProvider>`](/docs/react/api/components/gtprovider) に依存します。
  アプリのルートで provider によってラップされていることを確認してください。
* `useDefaultLocale` はクライアントサイドでのみ利用できます。
* ロケール文字列の詳細は、[こちら](/docs/core/locales)を参照してください。

## 次のステップ

* ユーザーのロケールを取得するには、[`useLocale`](/docs/react/api/helpers/use-locale)を参照してください。