• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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 '@ohos.i18n';
18   import { BusinessError } from '@ohos.base';
19   ```
20
212. 获取系统语言、系统地区、系统区域。
22   ```ts
23   // 获取系统语言
24   try {
25     let systemLanguage = I18n.System.getSystemLanguage();  // systemLanguage为当前系统语言
26   } catch(error) {
27     console.error(`call System.getSystemLanguage failed, error code: ${error.code}, message: ${error.message}.`);
28   }
29
30   // 获取系统地区
31   try {
32     let systemRegion = I18n.System.getSystemRegion();  // systemRegion为当前系统地区
33   } catch(error) {
34     console.error(`call System.getSystemRegion failed, error code: ${error.code}, message: ${error.message}.`);
35   }
36
37   // 获取系统区域
38   try {
39     let systemLocale = I18n.System.getSystemLocale();  // systemLocale为当前系统区域
40   } catch(error) {
41     console.error(`call System.getSystemLocale failed, error code: ${error.code}, message: ${error.message}.`);
42   }
43   ```
44
453. 设置系统语言、系统地区、系统区域。
46   ```ts
47   // 设置系统当前语言为 "zh"
48   try {
49     I18n.System.setSystemLanguage('zh');
50   } catch(error) {
51     let err: BusinessError = error as BusinessError;
52     console.error(`call System.setSystemLanguage failed, error code: ${err.code}, message: ${err.message}.`);
53   }
54
55   // 设置系统当前地区为 "CN"
56   try {
57     I18n.System.setSystemRegion('CN');
58   } catch(error) {
59     let err: BusinessError = error as BusinessError;
60     console.error(`call System.setSystemRegion failed, error code: ${err.code}, message: ${err.message}.`);
61   }
62
63   // 设置系统当前区域为 "zh-Hans-CN"
64   try {
65     I18n.System.setSystemLocale('zh-Hans-CN');
66   } catch(error) {
67     let err: BusinessError = error as BusinessError;
68     console.error(`call System.setSystemLocale failed, error code: ${err.code}, message: ${err.message}.`);
69   }
70   ```
71