# generaltranslation: General Translation Core SDK: getLocaleName
URL: https://generaltranslation.com/ja/docs/core/functions/locales/get-locale-name.mdx
---
title: getLocaleName
description: スタンドアロンの getLocaleName 関数の API リファレンス
---

## 概要

スタンドアロンの`getLocaleName`関数は、GTクラスのインスタンスを作成せずにロケールコードの表示名を取得します。
`Intl.DisplayNames` APIを使用して、有効な任意のBCP-47ロケールコードに対応するローカライズされたロケール名を返します。

```typescript
import { getLocaleName } from 'generaltranslation';

const name = getLocaleName('fr-CA', 'en');
console.log(name); // "French (Canada)"
```

***


## リファレンス

### パラメーター

<TypeTable
  type={{
  "locale": {
    type: 'string',
    optional: false,
  },
  "defaultLocale?": {
    type: 'string',
    optional: true,
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
  }
}}
/>

### パラメーターの説明

| パラメーター          | 説明                                            |
| --------------- | --------------------------------------------- |
| `locale`        | 表示名を取得する対象の BCP-47 ロケールコード                    |
| `defaultLocale` | 表示名をローカライズする際に使用するロケール (デフォルトは &#39;en&#39;)  |
| `customMapping` | ロケールコードと名前に対する任意のカスタムマッピング                    |

### 戻り値

`string` - ローカライズされたロケールの表示名。

***

## 動作

### 表示言語の決定

この関数は、次の優先順位で名前をローカライズします。

1. `defaultLocale` パラメーター (指定されている場合) 
2. ライブラリのデフォルトロケール (`en`)

### カスタムマッピングとの連携

* ロケールコードと名前の両方で、まずカスタムマッピングが参照されます
* エイリアスの解決とカスタム表示名に対応しています
* マッピングされていないコードは、標準の Intl.DisplayNames にフォールバックします

### 名前解決戦略

1. **カスタムのマッピング名** (最優先) 
2. デフォルトロケールの **Intl.DisplayNames**
3. ライブラリのデフォルト (`en`) の **Intl.DisplayNames**
4. **ロケールコード自体** (フォールバック) 

***

## 例

```typescript
import { getLocaleName } from 'generaltranslation';

// 英語の表示名
console.log(getLocaleName('es', 'en')); // "Spanish (Spain)"
console.log(getLocaleName('ja', 'en')); // "Japanese (Japan)"
console.log(getLocaleName('zh', 'en')); // "Chinese (China)"
```


### ロケールオプションの構築

```typescript
import { getLocaleName, getLocaleEmoji } from 'generaltranslation';

function buildLocaleOptions(
  supportedLocales: string[],
  displayLocale: string = 'en'
) {
  return supportedLocales.map(locale => ({
    value: locale,
    label: getLocaleName(locale, displayLocale),
    emoji: getLocaleEmoji(locale)
  }));
}

const options = buildLocaleOptions([
  'en',
  'es',
  'fr',
  'de',
  'ja'
], 'en');

console.log(options);
// [
//   { value: 'en', label: 'English (United States)', emoji: '🇺🇸' },
//   { value: 'es', label: 'Spanish (Spain)', emoji: '🇪🇸' },
//   ...
// ]
```

***


## 注記

* カスタムマッピングは標準の `Intl.DisplayNames` より優先されます
* 表示名を特定できない場合は、ロケールコード自体を返します
* 表示ロケールのパラメーターによって、返される名前の言語が決まります

## 次のステップ

* [`getLocaleEmoji`](/docs/core/functions/locales/get-locale-emoji) でロケールの絵文字を取得する
* 状態を持つ操作には、GT クラスメソッド [`getLocaleName`](/docs/core/class/methods/locales/get-locale-name) を使用する
* [`CustomMapping` 型](/docs/core/types/custom-mapping) について学ぶ