# General Translation Platform: isSupersetLocale
URL: https://generaltranslation.com/zh/docs/platform/core/reference/gt-class-methods/locales/is-superset-locale.mdx
---

title: isSupersetLocale
description: 检查一个区域设置是否可以代表另一个更具体的区域设置。isSupersetLocale 的 API 参考。

---

检查在 [GT](/docs/platform/core/reference/gt-class/constructor) 实例中，一个区域设置在 BCP-47 层级中是否为另一个区域设置的超集。超集区域设置更通用，可作为更具体区域设置的后备内容。General Translation 用它来判断区域设置的后备内容链。

## 概览 [#overview]

在 [`GT`](/docs/platform/core/reference/gt-class/constructor) 实例上调用 `isSupersetLocale`，并传入一个候选 超集 区域设置和一个候选 子集 区域设置。如果第一个是第二个的 超集，则返回 `true`。

```typescript
const gt = new GT();

console.log(gt.isSupersetLocale('en', 'en-US')); // true
console.log(gt.isSupersetLocale('en-US', 'en')); // false
```

签名：

```typescript
isSupersetLocale(superLocale: string, subLocale: string): boolean
```

*注意：`isSupersetLocale` 在本地运行，无需 API 密钥。如需在没有 `GT` 实例的情况下进行比较，请参阅独立使用的 [`isSupersetLocale`](/docs/platform/core/reference/utility-functions/locales/is-superset-locale)。*

## 工作方式 [#how-it-works]

* **BCP-47 层级。** 使用 BCP-47 区域设置层级进行比较。
* **自反性。** 区域设置始终是其自身的超集。
* **基础语言。** 基础语言是其区域变体的超集，但区域变体不是其基础语言的超集。
* **不同语言。** 对于完全不同的语言，返回 `false`。

## 参数 [#parameters]

| 参数                             | 描述              | 类型       | 可选 | 默认 |
| ------------------------------ | --------------- | -------- | -- | -- |
| [`superLocale`](#super-locale) | 要检查其是否为超集的区域设置。 | `string` | 否  | —  |
| [`subLocale`](#sub-locale)     | 要检查其是否为子集的区域设置。 | `string` | 否  | —  |

### `superLocale` [#super-locale]

**类型** `string` · **必需**

要检查其是否为超集 (即更通用区域设置) 的区域设置。

### `subLocale` [#sub-locale]

**类型** `string` · **必填**

要检查的子区域设置 (即更具体的区域设置) 。

## 返回值 [#returns]

**类型** `boolean`

如果 `superLocale` 是 `subLocale` 的超集，则返回 `true`；否则返回 `false`。

## 示例 [#examples]

```typescript
const gt = new GT();

// 基础语言是区域变体的超集
console.log(gt.isSupersetLocale('en', 'en-US')); // true
console.log(gt.isSupersetLocale('es', 'es-ES')); // true
console.log(gt.isSupersetLocale('zh', 'zh-CN')); // true

// 区域变体不是基础语言的超集
console.log(gt.isSupersetLocale('en-US', 'en')); // false
console.log(gt.isSupersetLocale('es-ES', 'es')); // false

// 相同的区域设置
console.log(gt.isSupersetLocale('en-US', 'en-US')); // true

// 不同语言
console.log(gt.isSupersetLocale('en', 'es-ES')); // false
```

## 注意事项 [#notes]

* 使用 BCP-47 区域设置层级进行比较。
* 区域设置始终是其自身的超集。
* 基础语言是其区域变体的超集。
* 对于完全不同的语言，返回 `false`。