# generaltranslation: General Translation Core SDK: requiresTranslation
URL: https://generaltranslation.com/ja/docs/core/functions/locales/requires-translation.mdx
---
title: requiresTranslation
description: requiresTranslation 関数のAPIリファレンス
---

## 概要

`requiresTranslation` 関数は、GT クラスのインスタンスがなくても、ソースロケールと対象ロケールの間で翻訳が必要かどうかを判定します。

***

## リファレンス

### パラメータ

<TypeTable
  type={{
  "sourceLocale": {
    type: 'string',
    optional: false,
  },
  "targetLocale": {
    type: 'string',
    optional: false,
  },
  "approvedLocales?": {
    type: 'string[]',
    optional: true,
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
  }
}}
/>

### 戻り値

`boolean` - 翻訳が必要な場合は `true`、不要な場合は `false`

***

## 例

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

// 異なる言語は翻訳が必要
console.log(requiresTranslation('en-US', 'es-ES')); // true
console.log(requiresTranslation('en-US', 'fr-FR')); // true

// 同じ言語は翻訳不要
console.log(requiresTranslation('en-US', 'en-US')); // false
console.log(requiresTranslation('en-US', 'en-GB')); // false

// 承認済みロケールフィルターを使用
const approved = ['en-US', 'es-ES', 'fr-FR'];
console.log(requiresTranslation('en-US', 'it-IT', approved)); // false (未承認)
console.log(requiresTranslation('en-US', 'es-ES', approved)); // true (承認済みかつ異なる)
```

***


## 注記

* 承認済みのロケール制約に従います
* 対象が承認済みリストに含まれていない場合は false を返します
* カスタムのロケールマッピングも考慮します

## 次のステップ

* GT クラスメソッド [`requiresTranslation`](/docs/core/class/methods/locales/requires-translation) を使用する
* [`isSameLanguage`](/docs/core/functions/locales/is-same-language) を使って言語を比較する