# General Translation React SDKs (gt-react, gt-next): getLocale URL: https://generaltranslation.com/zh/docs/react/nextjs/reference/functions/get-locale.mdx --- title: getLocale description: 使用 General Translation 读取当前 Next.js App Router 请求的区域设置。getLocale API 参考。 --- `getLocale` 函数会以 BCP 47 区域设置代码的形式，返回当前 App Router 请求的区域设置。在异步组件、Route Handlers 和其他服务端代码中，可从 `gt-next/server` 导入它。 `getLocale` 仅可用于服务端，不适用于 Pages Router。 ## 概览 [#overview] ```tsx import { getLocale } from 'gt-next/server'; const locale = await getLocale(); // 例如 'en-US' ``` ## 返回值 [#returns] **类型** `Promise` 一个 Promise，解析后返回当前请求的区域设置。General Translation 会通过已配置的请求区域设置函数解析该区域设置，并在需要时回退到默认区域设置。 ## 示例 [#example] ```tsx title="app/[locale]/layout.tsx" import { getLocale } from 'gt-next/server'; export default async function LocaleLayout({ children }) { const locale = await getLocale(); return {children}; } ```