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

title: isSupersetLocale
description: 检查一个区域设置是否可以在不依赖 GT 实例的情况下表示另一个更具体的区域设置。isSupersetLocale 的 API 参考。

---

[`isSupersetLocale`](/docs/platform/core/reference/gt-class-methods/locales/is-superset-locale) 是 General Translation Core 库中的一个独立工具函数，用于检查一个区域设置在 BCP-47 层级中是否为另一个区域设置的超集——也就是说，它是否可以表示更具体的那个区域设置。

## 概览 [#overview]

直接从 `generaltranslation` 导入 `isSupersetLocale`，并传入一个上位区域设置和一个下位区域设置来调用它。它不需要 API 密钥，也不需要 [GT](/docs/platform/core/reference/gt-class/constructor) 实例。若要使用基于实例的等效写法，请改用 [`GT`](/docs/platform/core/reference/gt-class/constructor) 实例上的 [`isSupersetLocale`](/docs/platform/core/reference/gt-class-methods/locales/is-superset-locale) 方法。

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

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

签名：

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

## 工作原理 [#how-it-works]

* **层级检查。** 采用 BCP-47 区域设置层级。如果 `subLocale` 是 `superLocale` 的扩展，或与其完全相同，那么 `subLocale` 就是 `superLocale` 的子集。
* **基础语言。** 基础语言是其区域变体的超集，但区域变体不是其基础语言的超集。
* **自反性。** 区域设置始终是自身的超集。

## 参数 [#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
import { isSupersetLocale } from 'generaltranslation';

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

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

// 区域设置始终是其自身的超集
console.log(isSupersetLocale('en-US', 'en-US')); // true
```

## 备注 [#notes]

* 使用 BCP-47 区域设置层级。
* 基础语言是区域变体的超集。
* 区域设置始终是其自身的超集。
* 对构建后备机制至关重要。