# generaltranslation: General Translation Core SDK: isSupersetLocale
URL: https://generaltranslation.com/zh/docs/core/class/methods/locales/is-superset-locale.mdx
---
title: isSupersetLocale
description: GT isSupersetLocale 方法的 API 参考文档
---

## 概述

`isSupersetLocale` 方法用于检查在 BCP-47 层级中，一个区域设置是否为另一个区域设置的超集。
超集区域设置更为通用，可作为更具体区域设置的回退。

***

## 参考

### 参数

<TypeTable
  type={{
  "superLocale": {
    type: 'string',
    optional: false,
  },
  "subLocale": {
    type: 'string',
    optional: false,
  }
}}
/>

### 返回值

`boolean` - 如果 `superLocale` 是 `subLocale` 的超集，则返回 `true`

***

## 示例

```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
```

***


## 说明

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

## 后续步骤

* 使用 [`isSameLanguage`](/docs/core/class/methods/locales/is-same-language) 比较是否为同一种语言
* 使用 [`isSameDialect`](/docs/core/class/methods/locales/is-same-dialect) 比较是否为同一种方言