1# Globalization Subsystem Changelog 2 3## cl.global.1 Change in the Localized Names of Countries/Regions 4 5**Access Level** 6 7Public API 8 9**Reason for Change** 10 11 1. The localized names for the Hong Kong, Macao, and Taiwan regions of China use commas or spaces as separators, which can lead to ambiguity when multiple countries/regions are listed together. 12 2. The country name of the State of Palestine has been changed internationally from Palestinian Territories to Palestine. 13 14**Change Impact** 15 16This change is a non-compatible change. 17 18Before the change: A comma or space is used as the separator between the localized names of the region and home country. 19 20After the change: The localized name of the home country is placed in the parentheses after the region, for example, Hong Kong (China). 21 22Before the change: The localized name of the State of Palestine is Palestinian Territories. 23 24After the change: The localized name of the State of Palestine is Palestine. 25 26**Start API Level** 27 289 29 30**Change Since** 31 32OpenHarmony SDK 5.0.0.51 33 34**Key API/Component Changes** 35 36i18n.System.getDisplayCountry 37 38**Adaptation Guide** 39 40Do not perform special judgment on the return values of the API. The values are used only for display on the UI. 41 42 43## cl.global.2 Change in the Localized Names of Countries/Regions 44 45**Access Level** 46 47System API 48 49**Reason for Change** 50 51 1. The localized names for the Hong Kong, Macao, and Taiwan regions of China use commas or spaces as separators, which can lead to ambiguity when multiple countries/regions are listed together. 52 2. The country name of the State of Palestine has been changed internationally from Palestinian Territories to Palestine. 53 54**Change Impact** 55 56This change is a non-compatible change. 57 58Before the change: A comma or space is used as the separator between the localized names of the region and home country. 59 60After the change: The localized name of the home country is placed in the parentheses after the region, for example, Hong Kong (China). 61 62Before the change: The localized name of the State of Palestine is Palestinian Territories. 63 64After the change: The localized name of the State of Palestine is Palestine. 65 66**Start API Level** 67 6810 69 70**Change Since** 71 72OpenHarmony SDK 5.0.0.51 73 74**Key API/Component Changes** 75 76i18n.SystemLocaleManager.getRegionInfoArray 77 78**Adaptation Guide** 79 80Do not perform special judgment on the return values of the API. The values are used only for display on the UI. 81 82 83## cl.global.3 Modification of the Incorrect Date and Time Formatting Result for November in the Lunar Calendar 84 85**Access Level** 86 87Public API 88 89**Reason for Change** 90 91In accordance with industry standards, the eleventh month in the lunar calendar should be displayed as Winter Month. 92 93**Change Impact** 94 95This change is a non-compatible change. 96 97Before change: The eleventh month is treated as November in the date and time formatting result. 98 99After change: The eleventh month is treated as Winter Month in the date and time formatting result. 100 101**Start API Level** 102 103API 6 104 105**Change Since** 106 107OpenHarmony SDK 5.0.0.51 108 109**Key API/Component Changes** 110 111intl.DateTimeFormat.format 112 113**Adaptation Guide** 114 115Do not perform special judgment on the return values of the API. The values are used only for display on the UI. 116 117 118## cl.global.4 Modification of the Incorrect Date and Time Formatting Result in zh-Hant-HK 119 120**Access Level** 121 122Public API 123 124**Reason for Change** 125 126When the locale is **zh-Hant-HK**, the date and time formatting result is empty. 127 128**Change Impact** 129 130This change is a non-compatible change. 131 132Before change: When the locale is **zh-Hant-HK**, the date and time formatting result is empty. 133 134After change: When the locale is **zh-Hant-HK**, the correct date and time formatting result is returned. 135 136**Start API Level** 137 1386 139 140**Change Since** 141 142OpenHarmony SDK 5.0.0.51 143 144**Key API/Component Changes** 145 146intl.DateTimeFormat.formatRange 147 148**Adaptation Guide** 149 150Do not perform special judgment on the return values of the API. The values are used only for display on the UI. 151 152 153## cl.global.5 Modification of the Incorrect Home Location Calculation for Invalid Numbers 154 155**Access Level** 156 157Public API 158 159**Reason for Change** 160 161If an invalid number is passed to **getLocationName**, the locale passed to the **PhoneNumberFormat** object is returned as the home location of the number. 162 163**Change Impact** 164 165This change is a non-compatible change. 166 167Before change: If an invalid number is passed to **getLocationName**, the locale passed to the **PhoneNumberFormat** object is returned as the home location of the number. 168 169After change: If an invalid number is passed to **getLocationName**, an empty string is returned. 170 171**Start API Level** 172 173API 9 174 175**Change Since** 176 177OpenHarmony SDK 5.0.0.51 178 179**Key API/Component Changes** 180 181i18n.PhoneNumberFormat.getLocationName 182 183**Adaptation Guide** 184 185Do not perform special judgment on the return values of the API. The values are used only for display on the UI. 186 187## cl.global.6 Change in the List of Supported Countries/Regions 188 189**Access Level** 190 191Public API 192 193**Reason for Change** 194 195Bhutan is not in the list of countries/regions supported by the system. 196 197**Change Impact** 198 199This change is a non-compatible change. 200 201Before change: Bhutan is not in the list of countries/regions supported by the system. 202 203After change: Bhutan is in the list of countries/regions supported by the system. 204 205**Start API Level** 206 207API 9 208 209**Change Since** 210 211OpenHarmony SDK 5.0.0.51 212 213**Key API/Component Changes** 214 215i18n.System.getSystemCountries 216 217**Adaptation Guide** 218 219Do not forcibly check the array size in the return value. 220