# generaltranslation: General Translation Core SDK: requiresTranslation
URL: https://generaltranslation.com/zh/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) 比较语言