# 全球化子系统Changelog

## cl.global.1 国家、地区本地化名称变更

**访问级别**

公开接口

**变更原因**

 1、当前中国香港、中国澳门、中国台湾地区的本地化名称中使用逗号或空格作为分隔符，当多个国家并列时，存在歧义。
 2、巴勒斯坦国家名称在国际上已由“巴勒斯坦领土”变更为“巴勒斯坦”

**变更影响**

该变更为不兼容性变更。

变更前：使用逗号或者空格作为地区与归属地国家之间的分隔符

变更后：使用将归属地国家放入地区后的小括号中，例如“Hong Kong(China)”

变更前：巴勒斯坦国家名称为“巴勒斯坦领土”

变更后：巴勒斯坦国家名称为“巴勒斯坦”

**起始API Level**

9

**变更发生版本**

从OpenHarmony SDK 5.0.0.51开始

**变更的接口/组件**

i18n.system.getDisplayCountry

**适配指导**

不要对接口返回值做特殊判断，该接口返回值仅用于界面显示。


## cl.global.2 国家、地区本地化名称变更

**访问级别**

系统接口

**变更原因**

 1、当前中国香港、中国澳门、中国台湾地区的本地化名称中使用逗号或空格作为分隔符，当多个国家并列时，存在歧义。
 2、巴勒斯坦国家名称在国际上已由“巴勒斯坦领土”变更为“巴勒斯坦”

**变更影响**

该变更为不兼容性变更。

变更前：使用逗号或者空格作为地区与归属地国家之间的分隔符

变更后：使用将归属地国家放入地区后的小括号中，例如“Hong Kong(China)”

变更前：巴勒斯坦国家名称为“巴勒斯坦领土”

变更后：巴勒斯坦国家名称为“巴勒斯坦”

**起始API Level**

10

**变更发生版本**

从OpenHarmony SDK 5.0.0.51开始

**变更的接口/组件**

i18n.system.getRegionInfoArray

**适配指导**

不要对接口返回值做特殊判断，该接口返回值仅用于界面显示。


## cl.global.3 时间日期格式“十一月”格式化结果错误问题修改

**访问级别**

公开接口

**变更原因**

参考业界标准，农历中“十一月”应该显示为“冬月”。

**变更影响**

该变更为不兼容变更。

变更前：接口格式化结果中的十一月份显示为“十一月”

变更后：接口格式化结果中的十一月份显示为“冬月”

**起始API Level**

API 6

**变更发生版本**

从OpenHarmony SDK 5.0.0.51开始。

**变更的接口/组件**

intl.DateTimeFormat.format

**适配指导**

不要对该接口的返回值做特殊的判断，该接口返回值仅用于界面显示。


## cl.global.4  日期时间段格式化在zh-Hant-HK下结果错误问题修改

**访问级别**

公开接口

**变更原因**

当区域为zh-Hant-HK时，日期时间段格式化结果返回空字串。

**变更影响**

该变更为不兼容变更。

变更前：当区域为zh-Hant-HK时，日期时间段格式化结果返回空字串。

变更后：当区域为zh-Hant-HK时，日期时间段格式化结果返回正确的格式化结果

**起始API Level**

6

**变更发生版本**

从OpenHarmony SDK 5.0.0.51 版本开始。

**变更的接口/组件**

intl.DateTimeFormat.formatRange

**适配指导**

不要对该接口的返回值做特殊的判断，该接口返回值仅用于界面显示。 


## cl.global.5 归属地获取接口对无效号码的归属计算错误问题修改

**访问级别**

公开接口

**变更原因**

归属地获取接口在传入无效号码时，会返回PhoneNumberFormat对象创建时传入的地区作为号码归属地

**变更影响**

该变更为不兼容变更。

变更前：归属地获取接口在传入无效号码时，会返回PhoneNumberFormat对象创建时传入的地区作为号码归属地。

变更后：归属地获取接口在传入无效号码时，返回空字串。

**起始API Level**

API 9

**变更发生版本**

从OpenHarmony SDK 5.0.0.51开始。

**变更的接口/组件**

intl.PhoneNumberFormat.getLocationName

**适配指导**

不要对该接口的返回值做特殊的判断，该接口返回值仅用于界面显示。

## cl.global.6  系统支持国家地区列表变更

**访问级别**

公开接口

**变更原因**

不丹当前不在系统支持的国家地区列表中

**变更影响**

该变更为不兼容变更。

变更前：系统支持的国家地区列表中不包含不丹

变更后：系统支持的国家地区列表中包含不丹

**起始API Level**

API 9

**变更发生版本**

从OpenHarmony SDK 5.0.0.51 版本开始。

**变更的接口/组件**

i18n.system.getSystemCountries

**适配指导**

不要对接口返回字符串数字的数量做强制判断