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

## 概述

`standardizeLocale` 函数用于标准化 BCP-47 区域设置代码，确保其格式和大小写正确，而无需 GT 类实例。

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

// 修复常见格式问题
console.log(standardizeLocale('en_us')); // 'en-US'
console.log(standardizeLocale('zh_cn')); // 'zh-CN'
console.log(standardizeLocale('EN-gb')); // 'en-GB'
console.log(standardizeLocale('fr-ca')); // 'fr-CA'

// 已标准化的区域设置将直接通过
console.log(standardizeLocale('es-ES')); // 'es-ES'
```

***


## 参考文档

### 参数

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

### 返回值

`string` - 标准化的 BCP-47 区域设置代码；如果无效，则返回空字符串

***

## 示例

### 用户输入处理

```typescript
import { standardizeLocale, isValidLocale } from 'generaltranslation';

function processUserInput(input: string) {
  const standardized = standardizeLocale(input.trim());
  const isValid = isValidLocale(standardized);
  
  return {
    original: input,
    standardized,
    isValid
  };
}

// 测试各种输入
const inputs = ['en_us', 'FR-ca', 'invalid', 'zh-CN'];
inputs.forEach(input => {
  console.log(processUserInput(input));
});
```

***


## 说明

* 将下划线转换为连字符
* 规范大小写 (语言代码小写，地区代码大写) 
* 对无效格式返回空字符串
* 对规范化来自不同来源的区域设置输入至关重要
* 无外部依赖，仅进行纯字符串处理

## 后续步骤

* 使用 GT 类的 [`standardizeLocale`](/docs/core/class/methods/locales/standardize-locale) 方法
* 使用 [`isValidLocale`](/docs/core/functions/locales/is-valid-locale) 验证