# General Translation React SDKs (gt-react, gt-next): useSetLocale
URL: https://generaltranslation.com/ja/docs/react/reference/hooks/use-set-locale.mdx
---

title: useSetLocale
description: General Translation の gt-react でアクティブなロケールを変更します。useSetLocale の API リファレンス。

---

`useSetLocale` フックは、アクティブなロケールを変更する関数を返します。クライアントサイド専用です。

*`gt-react`、`gt-next`、`gt-tanstack-start`、`gt-react-native` で利用できます。例では `gt-react` から import していますが、実際にはお使いのフレームワークのパッケージから import してください。*

## 概要 [#overview]

`useSetLocale` を呼び出してセッターを取得し、その後ロケールコードを指定して呼び出します。

```tsx
import { useSetLocale } from 'gt-react';

export default function LocaleButton() {
  const setLocale = useSetLocale();
  return <button onClick={() => setLocale('en')}>Set locale</button>;
}
```

*注: `useSetLocale` はクライアントサイド専用です。*

## 仕組み [#how-it-works]

返された関数を呼び出すと、選択したロケールがcookieに保存され、ページが再読み込みされて新しいロケールの翻訳が適用されます。

## 戻り値 [#returns]

**型** `(locale: string) => void`

指定されたコードをアクティブなロケールとして設定する関数です。

## メモ [#notes]

* `useSetLocale` はクライアントサイド専用です。
* アクティブなロケールを確認するには、[`useLocale`](/docs/react/reference/hooks/use-locale) を使用します。すぐに使える切り替え UI には、[`<LocaleSelector>`](/docs/react/reference/components/locale-selector) を使用します。