# General Translation React SDKs (gt-react, gt-next, gt-react-native): getLocale
URL: https://generaltranslation.com/ja/docs/react/tanstack-start/reference/functions/get-locale.mdx
---

title: getLocale
description: General Translation を使用して、現在の TanStack Start Runtime ロケールを取得します。getLocale の API リファレンス。

---

`getLocale` 関数は、現在のサーバーリクエストまたはブラウザーに関連付けられたロケールを BCP 47 ロケールコードとして返します。`gt-tanstack-start` からインポートします。

## 概要 [#overview]

```ts
import { getLocale } from 'gt-tanstack-start';

const locale = getLocale(); // 'en-US'
```

```ts
getLocale(): string
```

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

サーバーでは、`getLocale` は [`gtMiddleware`](/docs/react/tanstack-start/reference/functions/gt-middleware) によって作成されたリクエストローカルの値を読み取ります。`localeRouting` を有効にすると、ミドルウェアは最初にパスのプレフィックスからロケールを解決し、次にロケール cookie、`Accept-Language` ヘッダー、`defaultLocale` の順で判定します。ロケールルーティングを使用しない場合は、cookie から解決を開始します。

ブラウザーでは、[`initializeGT`](/docs/react/reference/config#initialize) によって初期化された condition store を読み取ります。この関数は同期関数です。サーバー側での呼び出しは、アクティブなミドルウェアのリクエストスコープ外では例外をスローします。

<Callout type="info">
  **v11 での変更:** 非推奨の `parseLocale()` ではなく `getLocale()` を使用し、Runtime helper は `gt-tanstack-start/server` ではなく `gt-tanstack-start` から import してください。
</Callout>

## 戻り値 [#returns]

**型** `string`

現在のリクエストのロケール。

## 例 [#example]

```ts
import { createServerFn } from '@tanstack/react-start';
import { getLocale } from 'gt-tanstack-start';

export const loadLocale = createServerFn({ method: 'GET' }).handler(() => {
  return getLocale();
});
```