1# 设置系统语言与区域
2
3
4## 实现原理
5
6在设置的“语言和地区”中可以添加多种语言，多种语言形成的列表称为语言列表，列表中的第一个语言称为系统语言。系统区域是依据区域标识划分的特定地区。
7
8当设置/切换系统语言时，系统会检查[扩展参数](i18n-locale-culture.md)与系统语言是否匹配，若不匹配，则删除扩展属性。例如，当前系统语言设置为阿拉伯语“ar”，使用本地数字为“arab”。当系统语言切换为马来西亚语“my”时，本地数字属性更改为马来西亚的本地数字“mymr”。当切换为中文时，因中文不支持设置本地数字，采用阿拉伯数字，因此本地数字的扩展属性会被移除。
9
10
11## 开发步骤
12
13接口具体使用方法和说明请参考[System](../reference/apis-localization-kit/js-apis-i18n.md#system9)的API接口文档。
14
151. 导入模块。
16   ```ts
17   import { i18n } from '@kit.LocalizationKit';
18   import { BusinessError } from '@kit.BasicServicesKit';
19   ```
20
212. 获取系统语言、系统地区、系统区域。
22   ```ts
23   // 获取系统语言
24   let systemLanguage = i18n.System.getSystemLanguage();  // systemLanguage为当前系统语言
25
26   // 获取系统地区
27   let systemRegion = i18n.System.getSystemRegion();  // systemRegion为当前系统地区
28
29   // 获取系统区域
30   let systemLocale = i18n.System.getSystemLocale();  // systemLocale为当前系统区域
31   ```
32<!--Del-->
333. 设置系统语言、系统地区、系统区域。
34   ```ts
35   // 设置系统当前语言为 "zh"
36   try {
37     i18n.System.setSystemLanguage('zh');
38   } catch(error) {
39     let err: BusinessError = error as BusinessError;
40     console.error(`call System.setSystemLanguage failed, error code: ${err.code}, message: ${err.message}.`);
41   }
42
43   // 设置系统当前地区为 "CN"
44   try {
45     i18n.System.setSystemRegion('CN');
46   } catch(error) {
47     let err: BusinessError = error as BusinessError;
48     console.error(`call System.setSystemRegion failed, error code: ${err.code}, message: ${err.message}.`);
49   }
50
51   // 设置系统当前区域为 "zh-Hans-CN"
52   try {
53     i18n.System.setSystemLocale('zh-Hans-CN');
54   } catch(error) {
55     let err: BusinessError = error as BusinessError;
56     console.error(`call System.setSystemLocale failed, error code: ${err.code}, message: ${err.message}.`);
57   }
58   ```
59<!--DelEnd-->