# General Translation React SDKs (gt-react, gt-next): useSetLocale
URL: https://generaltranslation.com/zh/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` 导入；请改为从你的框架对应的包中导入。*

## 概览 [#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)。如需现成的切换器，请使用 [`<LocaleSelector>`](/docs/react/reference/components/locale-selector)。