# 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 サーバーのリクエストロケールを取得します。getLocale の API リファレンス。

---

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

## 概要 [#overview]

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

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

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

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

`getLocale` は、[`gtMiddleware`](/docs/react/tanstack-start/reference/functions/gt-middleware) が作成したリクエストローカルの値を読み取ります。ミドルウェアは、設定されたクッキーとリクエストヘッダーからロケールを解決し、見つからない場合はデフォルトロケールにフォールバックします。

この関数は同期関数であり、有効なミドルウェアのリクエストスコープ外で呼び出すと例外をスローします。

## 戻り値 [#returns]

**型** `string`

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

## 例 [#example]

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

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