# generaltranslation: General Translation Core SDK: isSupersetLocale
URL: https://generaltranslation.com/zh/docs/core/functions/locales/is-superset-locale.mdx
---
title: isSupersetLocale
description: isSupersetLocale 函数的 API 参考文档
---

## 概述

`isSupersetLocale` 函数用于检查在 BCP-47 层级中，一个区域设置是否是另一个区域设置的超集，且无需 GT 类实例。

***

## 参考

### 参数

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

### 返回值

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

***

## 示例

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

***


## 说明

* 采用 BCP-47 区域设置层级
* 基础语言是各区域变体的超集
* 任何区域设置都是其自身的超集
* 对构建回退系统至关重要

## 后续步骤

* 使用 GT 类的 [`isSupersetLocale`](/docs/core/class/methods/locales/is-superset-locale) 方法
* 使用 [`isSameLanguage`](/docs/core/functions/locales/is-same-language) 比较语言