@openui5/sap.ui.core 1.119.1 → 1.120.0

package/src/sap/base/i18n/Localization.js

@@ -3,7 +3,6 @@
  * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
 */
-/*global globalThis*/
 sap.ui.define([
 	"sap/base/config",
 	"sap/base/Eventing",
@@ -20,16 +19,18 @@ sap.ui.define([
 	TimezoneUtils
 ) {
 	"use strict";
-	var mChanges;
-	var oWritableConfig = BaseConfig.getWritableInstance();
+
+	const oWritableConfig = BaseConfig.getWritableInstance();
 	let sLanguageSetByApi;
-	var bLanguageWarningLogged = false;
+	const oEventing = new Eventing();
+	let mChanges;
+	let bLanguageWarningLogged = false;
 
 	/**
 	 * A map of preferred Calendar types according to the language.
 	 * @private
 	 */
-	var _mPreferredCalendar = {
+	const _mPreferredCalendar = {
 		"ar-SA": CalendarType.Islamic,
 		"fa": CalendarType.Persian,
 		"th": CalendarType.Buddhist,
@@ -37,7 +38,7 @@ sap.ui.define([
 	};
 
 	// Note: keys must be uppercase
-	var M_ABAP_LANGUAGE_TO_LOCALE = {
+	const M_ABAP_LANGUAGE_TO_LOCALE = {
 		"ZH" : "zh-Hans",
 		"ZF" : "zh-Hant",
 		"SH" : "sr-Latn",
@@ -50,30 +51,29 @@ sap.ui.define([
 		"3Q" : "en-US-x-saprigi"
 	};
 
-	var M_ISO639_OLD_TO_NEW = {
+	const M_ISO639_OLD_TO_NEW = {
 		"iw" : "he",
 		"ji" : "yi"
 	};
 
-	var M_LOCALE_TO_ABAP_LANGUAGE = inverse(M_ABAP_LANGUAGE_TO_LOCALE);
-
-	function inverse(obj) {
-		return Object.keys(obj).reduce(function(inv, key) {
+	const M_LOCALE_TO_ABAP_LANGUAGE = ((obj) => {
+		return Object.keys(obj).reduce((inv, key) => {
 			inv[obj[key]] = key;
 			return inv;
 		}, {});
-	}
+	})(M_ABAP_LANGUAGE_TO_LOCALE);
 
 	/**
 	 * Maps wellknown private use extensions to pseudo language tags.
 	 * @param {string} sPrivateUse A Locale
 	 * @returns {string|undefined} the pseudo language tag or undefined
 	 * @private
+	 * @since 1.120.0
 	 */
 	function getPseudoLanguageTag(sPrivateUse) {
-		var sPseudoLanguageTag;
+		let sPseudoLanguageTag;
 		if ( sPrivateUse ) {
-			var m = /-(saptrc|sappsd|saprigi)(?:-|$)/i.exec(sPrivateUse);
+			const m = /-(saptrc|sappsd|saprigi)(?:-|$)/i.exec(sPrivateUse);
 			sPseudoLanguageTag = m && "en-US-x-" + m[1].toLowerCase();
 		}
 		return sPseudoLanguageTag;
@@ -96,9 +96,10 @@ sap.ui.define([
 	 * @param {string} sValue The raw designtime property e.g. $cldr-rtl-locales:ar,fa,he$
 	 * @returns {string[]|null} The designtime property e.g. ['ar', 'fa', 'he']
 	 * @private
+	 * @since 1.120.0
 	 */
 	function getDesigntimePropertyAsArray(sValue) {
-		var m = /\$([-a-z0-9A-Z._]+)(?::([^$]*))?\$/.exec(sValue);
+		const m = /\$([-a-z0-9A-Z._]+)(?::([^$]*))?\$/.exec(sValue);
 		return (m && m[2]) ? m[2].split(/,/) : null;
 	}
 
@@ -110,13 +111,13 @@ sap.ui.define([
 	 * The value is determined from the CLDR JSON files which are
 	 * bundled with the UI5 runtime.
 	 */
-	var A_RTL_LOCALES = getDesigntimePropertyAsArray("$cldr-rtl-locales:ar,fa,he$") || [];
+	const A_RTL_LOCALES = getDesigntimePropertyAsArray("$cldr-rtl-locales:ar,fa,he$") || [];
 
 	/**
 	 * List of locales for which translated texts have been bundled with the UI5 runtime.
 	 * @private
 	 */
-	var _coreI18nLocales = getDesigntimePropertyAsArray("$core-i18n-locales:,ar,bg,ca,cs,da,de,el,en,en_GB,es,es_MX,et,fi,fr,hi,hr,hu,it,iw,ja,kk,ko,lt,lv,ms,nl,no,pl,pt,ro,ru,sh,sk,sl,sv,th,tr,uk,vi,zh_CN,zh_TW$");
+	const _coreI18nLocales = getDesigntimePropertyAsArray("$core-i18n-locales:,ar,bg,ca,cs,da,de,el,en,en_GB,es,es_MX,et,fi,fr,hi,hr,hu,it,iw,ja,kk,ko,lt,lv,ms,nl,no,pl,pt,ro,ru,sh,sk,sl,sv,th,tr,uk,vi,zh_CN,zh_TW$");
 
 	/**
 	 * Retrieves a Locale for the given SAP logon language or BCP47 tag.
@@ -125,9 +126,10 @@ sap.ui.define([
 	 *   A SAP logon language, e.g. "ZF" or a BCP47 language tag
 	 * @returns {object} An object containing the mapped LogonLanguage and a LanguageTag if created
 	 * @private
+	 * @since 1.120.0
 	 */
 	function fromSAPLogonLanguage(sSAPLogonLanguage) {
-		var oLanguageTag;
+		let oLanguageTag;
 		if (sSAPLogonLanguage && typeof sSAPLogonLanguage === 'string') {
 			sSAPLogonLanguage = M_ABAP_LANGUAGE_TO_LOCALE[sSAPLogonLanguage.toUpperCase()] || sSAPLogonLanguage;
 			try {
@@ -136,10 +138,7 @@ sap.ui.define([
 				// ignore
 			}
 		}
-		return {
-			languageTag: oLanguageTag,
-			SAPLogonLanguage: sSAPLogonLanguage
-		};
+		return [oLanguageTag, sSAPLogonLanguage];
 	}
 
 	/**
@@ -150,9 +149,10 @@ sap.ui.define([
 	 * @returns {module:sap/base/i18n/LanguageTag} The resulting LanguageTag
 	 * @throws {TypeError} Throws a TypeError for unknown languages
 	 * @private
+	 * @since 1.120.0
 	 */
 	function createLanguageTag(sLanguage) {
-		var oLanguageTag;
+		let oLanguageTag;
 		if (sLanguage) {
 			oLanguageTag = new LanguageTag(sLanguage);
 		}
@@ -166,7 +166,7 @@ sap.ui.define([
 
 	function check(bCondition, sMessage) {
 		if ( !bCondition ) {
-			throw new Error(sMessage);
+			throw new TypeError(sMessage);
 		}
 	}
 
@@ -180,9 +180,10 @@ sap.ui.define([
 	 * @param {string} sTimezone The IANA timezone ID
 	 * @returns {boolean} Returns true if the timezone is valid
 	 * @private
+	 * @since 1.120.0
 	 */
 	function checkTimezone(sTimezone) {
-		var bIsValidTimezone = TimezoneUtils.isValidTimezone(sTimezone);
+		const bIsValidTimezone = TimezoneUtils.isValidTimezone(sTimezone);
 		if (!bIsValidTimezone) {
 			Log.error("The provided timezone '" + sTimezone + "' is not a valid IANA timezone ID." +
 				" Falling back to browser's local timezone '" + TimezoneUtils.getLocalTimezone() + "'.");
@@ -194,48 +195,76 @@ sap.ui.define([
 	 * Configuration for localization specific parameters
 	 * @public
 	 * @since 1.118
-	 * @ui5-restricted sap.ui.core
 	 * @alias module:sap/base/i18n/Localization
 	 * @namespace
-	 * @mixes module:sap/base/Eventing
-	 * @borrows module:sap/base/Eventing#attachEvent as attachEvent
-	 * @borrows module:sap/base/Eventing#attachEventOnce as attachEventOnce
-	 * @borrows module:sap/base/Eventing#detachEvent as detachEvent
-	 * @borrows module:sap/base/Eventing#fireEvent as fireEvent
-	 * @borrows module:sap/base/Eventing#hasListeners as hasListeners
-	 * @borrows module:sap/base/Eventing#getEventingParent as getEventingParent
-	 * @borrows module:sap/base/Eventing#toString as toString
 	 */
-	var Localization = {
+	const Localization = {
 		/**
 		 * The <code>change</code> event is fired, when the configuration options are changed.
+		 * For the event parameters please refer to {@link module:sap/base/i18n/Localization$ChangeEvent}.
 		 *
 		 * @name module:sap/base/i18n/Localization.change
 		 * @event
+		 * @param {module:sap/base/i18n/Localization$ChangeEvent} oEvent
 		 * @public
+		 * @since 1.120.0
 		 */
 
+		/**
+		 * The localization change event. Contains only the parameters which were changed.
+		 *
+		 * The list below shows the possible combinations of parameters available as part of the change event.
+		 *
+		 * <ul>
+		 * <li>{@link module:sap/base/i18n/Localization.setLanguage Localization.setLanguage}:
+		 * <ul>
+		 * <li><code>language</code></li>
+		 * <li><code>rtl?</code> (only if language change also changed RTL)</li>
+		 * </ul>
+		 * </li>
+		 * <li>{@link module:sap/base/i18n/Localization.setRTL Localization.setRTL}:
+		 * <ul>
+		 * <li><code>rtl</code></li>
+		 * </ul>
+		 * </li>
+		 * <li>{@link module:sap/base/i18n/Localization.setTimezone Localization.setTimezone}:
+		 * <ul>
+		 * <li><code>timezone</code></li>
+		 * </ul>
+		 * </li>
+		 * </ul>
+		 *
+		 * @typedef {object} module:sap/base/i18n/Localization$ChangeEvent
+		 * @property {string} [language] The newly set language.
+		 * @property {boolean} [rtl] Whether the page uses the RTL text direction.
+		 * @property {string} [timezone] The newly set timezone.
+		 * @public
+		 * @since 1.120.0
+		 */
 		/**
 		 * Attaches the <code>fnFunction</code> event handler to the {@link #event:change change} event
 		 * of <code>module:sap/base/i18n/Localization</code>.
 		 *
-		 * @param {function} fnFunction
+		 * @param {function(module:sap/base/i18n/Localization$ChangeEvent)} fnFunction
 		 *   The function to be called when the event occurs
 		 * @public
+		 * @since 1.120.0
+		 * @static
 		 */
 		attachChange: function(fnFunction) {
-			Localization.attachEvent("change", fnFunction);
+			oEventing.attachEvent("change", fnFunction);
 		},
 
 		/**
 		 * Detaches event handler <code>fnFunction</code> from the {@link #event:change change} event of
 		 * this <code>module:sap/base/i18n/Localization</code>.
 		 *
-		 * @param {function} fnFunction Function to be called when the event occurs
+		 * @param {function(module:sap/base/i18n/Localization$ChangeEvent)} fnFunction Function to be called when the event occurs
 		 * @public
+		 * @since 1.120.0
 		 */
 		detachChange: function(fnFunction) {
-			Localization.detachEvent("change", fnFunction);
+			oEventing.detachEvent("change", fnFunction);
 		},
 
 		/**
@@ -274,30 +303,33 @@ sap.ui.define([
 		 *                                    represented as en-US with a private extension
 		 * </pre>
 		 *
-		 * For a normalized BCP47 tag, call {@link #getLanguageTag} or call {@link #getLanguageTag} to get a
+		 * Call {@link moduel:sap/base/i18n/Localization.getLanguageTag getLanguageTag} to get a
 		 * {@link module:sap/base/i18n/LanguageTag LanguageTag} object matching the language.
+		 * For a normalized BCP47 tag, call {@link module:sap/base/i18n/LanguageTag.toString toString()}
+		 * on the returned <code>LanguageTag</code>
 		 *
 		 * @returns {string} Language string as configured
 		 * @public
+		 * @since 1.120.0
 		 */
 		getLanguage : function () {
-			var oLanguageTag,
+			let oLanguageTag,
 				sDerivedLanguage;
 
 			if (sLanguageSetByApi) {
 				return sLanguageSetByApi;
 			}
-			var sLanguage = oWritableConfig.get({
+			const sLanguage = oWritableConfig.get({
 				name: "sapUiLanguage",
 				type: BaseConfig.Type.String,
 				external: true
 			});
-			var sSapLocale = oWritableConfig.get({
+			const sSapLocale = oWritableConfig.get({
 				name: "sapLocale",
 				type: BaseConfig.Type.String,
 				external: true
 			});
-			var sSapLanguage = oWritableConfig.get({
+			const sSapLanguage = oWritableConfig.get({
 				name: "sapLanguage",
 				type: BaseConfig.Type.String,
 				external: true
@@ -314,9 +346,7 @@ sap.ui.define([
 					bLanguageWarningLogged = true;
 				}
 				//fromSAPLogonLanguage catches errors oLanguageTag could be undefined
-				var oSAPLogonLanguage = fromSAPLogonLanguage(sSapLanguage);
-				oLanguageTag = oSAPLogonLanguage.languageTag;
-				sDerivedLanguage = oSAPLogonLanguage.languageTag && oSAPLogonLanguage.SAPLogonLanguage;
+				[oLanguageTag, sDerivedLanguage] = fromSAPLogonLanguage(sSapLanguage);
 			}
 			if (!oLanguageTag) {
 				if (sLanguage) {
@@ -337,6 +367,7 @@ sap.ui.define([
 		 * @returns {string} The modern language
 		 * @private
 		 * @ui5-restricted sap.ui.core
+		 * @since 1.120.0
 		 */
 		getModernLanguage : function(sLanguage) {
 			return M_ISO639_OLD_TO_NEW[sLanguage] || sLanguage;
@@ -349,8 +380,8 @@ sap.ui.define([
 		 * When the language can't be interpreted as a BCP47 language (using the relaxed syntax
 		 * described in {@link #getLanguage}, an error will be thrown.
 		 *
-		 * When the language has changed, the Core will fire its
-		 * {@link sap.ui.core.Core#event:localizationChanged localizationChanged} event.
+		 * When the language has changed, the Localization will fire its
+		 * {@link module:sap/base/i18n/Localization.change change} event.
 		 *
 		 *
 		 * <h3>Restrictions</h3>
@@ -385,7 +416,8 @@ sap.ui.define([
 		 *
 		 * config method does not accept SAP language codes for <code>sLanguage</code>. Instead, a second
 		 * parameter <code>sSAPLogonLanguage</code> can be provided with an SAP language code corresponding
-		 * to the given language. A given value will be returned by the {@link #getSAPLogonLanguage} method.
+		 * to the given language. A given value will be returned by the
+		 * {@link module:sap/base/i18n/Localization.getSAPLogonLanguage getSAPLogonLanguage} method.
 		 * It is up to the caller to provide a consistent pair of BCP47 language and SAP language code.
 		 * The SAP language code is only checked to be of length 2 and must consist of letters or digits only.
 		 *
@@ -397,18 +429,19 @@ sap.ui.define([
 		 *   if a value is specified, future calls to <code>getSAPLogonLanguage</code> will return that value;
 		 *   if no value is specified, the framework will use the ISO639 language part of <code>sLanguage</code>
 		 *   as SAP Logon language.
-		 * @throws {Error} When <code>sLanguage</code> can't be interpreted as a BCP47 language or when
+		 * @throws {TypeError} When <code>sLanguage</code> can't be interpreted as a BCP47 language or when
 		 *   <code>sSAPLanguage</code> is given and can't be interpreted as SAP language code.
 		 *
 		 * @see http://scn.sap.com/docs/DOC-14377
 		 * @public
+		 * @since 1.120.0
 		 */
 		setLanguage : function (sLanguage, sSAPLogonLanguage) {
-			var oLanguageTag = createLanguageTag(sLanguage),
+			const oLanguageTag = createLanguageTag(sLanguage),
 				bOldRTL = Localization.getRTL();
-			check(oLanguageTag, "Configuration.setLanguage: sLanguage must be a valid BCP47 language tag");
+			check(oLanguageTag, "Localization.setLanguage: sLanguage must be a valid BCP47 language tag");
 			check(sSAPLogonLanguage == null || (typeof sSAPLogonLanguage === 'string' && /^[A-Z0-9]{2,2}$/i.test(sSAPLogonLanguage)),
-				"Configuration.setLanguage: sSAPLogonLanguage must be null or be a string of length 2, consisting of digits and latin characters only");
+				"Localization.setLanguage: sSAPLogonLanguage must be null or be a string of length 2, consisting of digits and latin characters only");
 
 			sSAPLogonLanguage = sSAPLogonLanguage || "";
 			if ( oLanguageTag.toString() != Localization.getLanguageTag().toString() ||
@@ -421,7 +454,7 @@ sap.ui.define([
 				sLanguageSetByApi = sLanguage;
 				mChanges = {};
 				mChanges.language = Localization.getLanguageTag().toString();
-				var bRtl = Localization.getRTL();
+				const bRtl = Localization.getRTL();
 				if ( bOldRTL != bRtl ) {
 					mChanges.rtl = bRtl;
 				}
@@ -434,9 +467,10 @@ sap.ui.define([
 		 *
 		 * @returns {string} The configured IANA timezone ID, e.g. "America/New_York"
 		 * @public
+		 * @since 1.120.0
 		 */
 		getTimezone : function () {
-			var sTimezone = oWritableConfig.get({
+			let sTimezone = oWritableConfig.get({
 				name: "sapTimezone",
 				type: BaseConfig.Type.String,
 				external: true,
@@ -463,19 +497,19 @@ sap.ui.define([
 		 * For more information, see
 		 * {@link topic:6c9e61dc157a40c19460660ece8368bc Dates, Times, Timestamps, and Time Zones}.
 		 *
-		 * When the timezone has changed, the Core will fire its
-		 * {@link module:sap/base/i18n/Localization#event:change change} event.
+		 * When the timezone has changed, the Localization will fire its {@link #event:change change} event.
 		 *
-		 * @param {string|null} [sTimezone] IANA timezone ID, e.g. "America/New_York". Use <code>null</code> to reset the timezone to the browser's local timezone.
-		 *   An invalid IANA timezone ID will fall back to the browser's timezone.
+		 * @param {string|null} [sTimezone] IANA timezone ID, e.g. "America/New_York".
+		 * Use <code>null</code> to reset the timezone to the browser's local timezone.
+		 * An invalid IANA timezone ID will fall back to the browser's timezone.
 		 * @public
-		 * @returns {this} <code>this</code> to allow method chaining
+		 * @since 1.120.0
 		 */
 		setTimezone : function (sTimezone) {
 			check(sTimezone == null || typeof sTimezone === 'string',
-				"Configuration.setTimezone: sTimezone must be null or be a string");
+				"Localization.setTimezone: sTimezone must be null or be a string");
 
-			var sCurrentTimezone = Localization.getTimezone();
+			const sCurrentTimezone = Localization.getTimezone();
 			sTimezone = sTimezone === null || !checkTimezone(sTimezone) ? undefined : sTimezone;
 			oWritableConfig.set("sapTimezone", sTimezone);
 			if (Localization.getTimezone() !== sCurrentTimezone) {
@@ -483,22 +517,22 @@ sap.ui.define([
 				mChanges.timezone = Localization.getTimezone();
 				fireChange();
 			}
-			return this;
 		},
 
 		/**
 		 * Returns a LanguageTag object for the current language.
 		 *
-		 * The LanguageTag is derived from the {@link #getLanguage language} property.
+		 * The LanguageTag is derived from {@link modue:sap/base/i18n/Localization.getLanguage Localization.getLanguage}.
 		 *
 		 * @returns {module:sap/base/i18n/LanguageTag} The LanguageTag
 		 * @public
+		 * @since 1.120.0
 		 */
 		getLanguageTag : function () {
-			var oLanguageTag = new LanguageTag(Localization.getLanguage());
-			var sLanguageTag = oLanguageTag.toString();
-			var sLanguage = Localization.getModernLanguage(oLanguageTag.language);
-			var sScript = oLanguageTag.script;
+			const oLanguageTag = new LanguageTag(Localization.getLanguage());
+			const sLanguage = Localization.getModernLanguage(oLanguageTag.language);
+			const sScript = oLanguageTag.script;
+			let sLanguageTag = oLanguageTag.toString();
 			// special case for "sr_Latn" language: "sh" should then be used
 			// config method is used to set the Accept-Language HTTP Header for ODataModel
 			// requests and .hdbtextbundle resource bundles.
@@ -519,6 +553,7 @@ sap.ui.define([
 		 *
 		 * @returns {boolean} whether the page uses the RTL text direction
 		 * @public
+		 * @since 1.120.0
 		 */
 		getRTL : function () {
 			// if rtl has not been set (still null), return the rtl mode derived from the language
@@ -545,26 +580,25 @@ sap.ui.define([
 		 *
 		 * After changing the character orientation mode, the framework tries
 		 * to update localization specific parts of the UI. See the documentation of
-		 * {@link #setLanguage} for details and restrictions.
+		 * {@link module:sap/base/i18n/Localization.setLanguage setLanguage} for details and restrictions.
 		 *
-		 * <b>Note</b>: See documentation of {@link #setLanguage} for restrictions.
+		 * <b>Note</b>: See documentation of {@link module:sap/base/i18n/Localization.setLanguage setLanguage} for restrictions.
 		 *
 		 * @param {boolean|null} bRTL new character orientation mode or <code>null</code>
-		 * @returns {this} <code>this</code> to allow method chaining
 		 * @public
+		 * @since 1.120.0
 		 */
 		setRTL : function(bRTL) {
 			check(bRTL === null || typeof bRTL === "boolean", "bRTL must be null or a boolean");
 			bRTL = bRTL === null ? undefined : bRTL;
-			var oldRTL = Localization.getRTL();
+			const oldRTL = Localization.getRTL();
 			oWritableConfig.set("sapRtl", bRTL);
-			var bCurrentRTL = Localization.getRTL();
+			const bCurrentRTL = Localization.getRTL();
 			if ( oldRTL != bCurrentRTL ) { // also take the derived RTL flag into account for the before/after comparison!
 				mChanges = {};
 				mChanges.rtl = bCurrentRTL;
 				fireChange();
 			}
-			return this;
 		},
 
 		/**
@@ -588,9 +622,10 @@ sap.ui.define([
 		 * @returns {string} a language code that should
 		 * @private
 		 * @ui5-restricted sap.ui.core
+		 * @since 1.120.0
 		 **/
 		_getSAPLogonLanguage : function(oLanguageTag) {
-			var sLanguage = oLanguageTag.language || "";
+			let sLanguage = oLanguageTag.language || "";
 
 			// cut off any ext. language sub tags
 			if ( sLanguage.indexOf("-") >= 0 ) {
@@ -621,17 +656,18 @@ sap.ui.define([
 		 *
 		 * @returns {string} The SAP logon language code for the current language
 		 * @public
+		 * @since 1.120.0
 		 */
 		getSAPLogonLanguage : function () {
-			var oLanguageTag,
-				sLanguage = oWritableConfig.get({
+			let oLanguageTag;
+			const sLanguage = oWritableConfig.get({
 				name: "sapLanguage",
 				type: BaseConfig.Type.String,
 				external: true
 			}).toUpperCase();
 
 			try {
-				oLanguageTag = fromSAPLogonLanguage(sLanguage).languageTag;
+				[oLanguageTag] = fromSAPLogonLanguage(sLanguage);
 			} catch (exc) {
 				//do nothing
 			}
@@ -647,9 +683,10 @@ sap.ui.define([
 		 * @returns {module:sap/base/i18n/date/CalendarType} The preferred Calendar type.
 		 * @private
 		 * @ui5-restricted sap.ui.core
+		 * @since 1.120.0
 		 */
 		getPreferredCalendarType : function() {
-			var oLocale = Localization.getLanguageTag();
+			const oLocale = Localization.getLanguageTag();
 			return _mPreferredCalendar[oLocale.language + "-" + oLocale.region] ||
 			_mPreferredCalendar[oLocale.language] ||
 			_mPreferredCalendar["default"];
@@ -664,6 +701,7 @@ sap.ui.define([
 		 * @experimental
 		 * @private
 		 * @ui5-restricted sap.ui.core
+		 * @since 1.120.0
 		 */
 		getLanguagesDeliveredWithCore : function() {
 			return _coreI18nLocales;
@@ -674,9 +712,10 @@ sap.ui.define([
 		 * @experimental
 		 * @private
 		 * @ui5-restricted sap.ui.core
+		 * @since 1.120.0
 		 */
 		getSupportedLanguages : function() {
-			var aLangs = BaseConfig.get({
+			let aLangs = BaseConfig.get({
 				name: "sapUiXxSupportedLanguages",
 				type: BaseConfig.Type.StringArray,
 				external: true
@@ -707,11 +746,12 @@ sap.ui.define([
 	 * @returns {boolean} <code>true</code> if <code>vLanguage</code> implies RTL,
 	 *  otherwise <code>false</code>
 	 * @private
+	 * @since 1.120.0
 	 */
 	function impliesRTL(oLanguageTag) {
-		var sLanguage = oLanguageTag.language || "";
+		let sLanguage = oLanguageTag.language || "";
 		sLanguage = Localization.getModernLanguage(oLanguageTag.language);
-		var sRegion = oLanguageTag.region || "";
+		const sRegion = oLanguageTag.region || "";
 		if ( sRegion && A_RTL_LOCALES.indexOf(sLanguage + "_" + sRegion) >= 0 ) {
 			return true;
 		}
@@ -719,10 +759,9 @@ sap.ui.define([
 	}
 
 	function fireChange() {
-		Localization.fireEvent("change", mChanges);
+		oEventing.fireEvent("change", mChanges);
 		mChanges = undefined;
 	}
 
-	Eventing.apply(Localization);
 	return Localization;
 });

package/src/sap/base/i18n/ResourceBundle.js

@@ -595,7 +595,7 @@ sap.ui.define([
 				// Alternative: add locale as query:
 				// url: oUrl.prefix + oUrl.suffix + '?' + (oUrl.query ? oUrl.query + "&" : "") + "locale=" + sLocale + (oUrl.hash ? "#" + oUrl.hash : ""),
 				mHeaders = {
-					"Accept-Language": convertLocaleToBCP47(sLocale) || ""
+					"Accept-Language": convertLocaleToBCP47(sLocale) || "*"
 				};
 			} else {
 				sUrl = oUrl.prefix + (sLocale ? "_" + sLocale : "") + oUrl.suffix;

package/src/sap/base/i18n/date/CalendarType.js

@@ -13,8 +13,8 @@ sap.ui.define([], function() {
 	 *
 	 * @enum {string}
 	 * @alias module:sap/base/i18n/date/CalendarType
-	 * @private
-	 * @ui5-restricted sap.ui.core sap/base/i18n
+	 * @public
+	 * @since 1.120
 	 */
 	var CalendarType = {
 

package/src/sap/base/i18n/date/CalendarWeekNumbering.js

@@ -17,9 +17,9 @@ sap.ui.define([], function() {
 	 * </ul>
 	 *
 	 * @enum {string}
-	 * @private
-	 * @ui5-restricted sap.ui.core sap/base/i18n
+	 * @public
 	 * @alias module:sap/base/i18n/date/CalendarWeekNumbering
+	 * @since 1.120
 	 */
 	var CalendarWeekNumbering = {
 

package/src/sap/base/i18n/date/TimezoneUtils.js

@@ -10,7 +10,7 @@ sap.ui.define([], function() {
 	 * Static collection of utility functions to handle time zone related conversions
 	 *
 	 * @author SAP SE
-	 * @version 1.119.1
+	 * @version 1.120.0
 	 * @namespace
 	 * @alias module:sap/base/i18n/date/TimezoneUtils
 	 * @private
@@ -268,20 +268,57 @@ sap.ui.define([], function() {
 	};
 
 	/**
-	 * Retrieves the browser's local IANA timezone ID.
+	 * Map outdated IANA timezone IDs used in CLDR to correct and up-to-date IANA IDs as maintained in ABAP systems.
+	 *
+	 * @private
+ 	 */
+	TimezoneUtils.mCLDR2ABAPTimezones = {
+		"America/Buenos_Aires": "America/Argentina/Buenos_Aires",
+		"America/Catamarca": "America/Argentina/Catamarca",
+		"America/Cordoba": "America/Argentina/Cordoba",
+		"America/Jujuy": "America/Argentina/Jujuy",
+		"America/Mendoza": "America/Argentina/Mendoza",
+		"America/Indianapolis": "America/Indiana/Indianapolis",
+		"America/Louisville": "America/Kentucky/Louisville",
+		"Africa/Asmera": "Africa/Asmara",
+		"Asia/Katmandu": "Asia/Kathmandu",
+		"Asia/Calcutta": "Asia/Kolkata",
+		"Atlantic/Faeroe": "Atlantic/Faroe",
+		"Pacific/Ponape": "Pacific/Pohnpei",
+		"Asia/Rangoon": "Asia/Yangon",
+		"Pacific/Truk": "Pacific/Chuuk",
+		"America/Godthab": "America/Nuuk",
+		"Asia/Saigon": "Asia/Ho_Chi_Minh",
+		"America/Coral_Harbour": "America/Atikokan"
+	};
+
+	/**
+	 * Retrieves the browser's local IANA timezone ID; if the browser's timezone ID is not the up-to-date IANA
+	 * timezone ID, the corresponding IANA timezone ID is returned.
+	 *
+	 * @returns {string} The local IANA timezone ID of the browser as up-to-date IANA timezone ID,
+	 *   e.g. <code>"Europe/Berlin"</code> or <code>"Asia/Kolkata"</code>
 	 *
-	 * @returns {string} The local IANA timezone ID of the browser, e.g <code>"Europe/Berlin"</code>
 	 * @private
 	 * @ui5-restricted sap.ui.core.Configuration,sap.m.DateTimeField
 	 */
 	TimezoneUtils.getLocalTimezone = function() {
-		if (sLocalTimezone) {
-			return sLocalTimezone;
+		if (sLocalTimezone === "") { // timezone may be undefined, only value "" means empty cache
+			sLocalTimezone = new Intl.DateTimeFormat().resolvedOptions().timeZone;
+			sLocalTimezone = TimezoneUtils.mCLDR2ABAPTimezones[sLocalTimezone] || sLocalTimezone;
 		}
-		sLocalTimezone = new Intl.DateTimeFormat().resolvedOptions().timeZone;
+
 		return sLocalTimezone;
 	};
 
+	/**
+	 * Clears the cache for the browser's local IANA timezone ID.
+	 *
+	 * @private
+	 */
+	TimezoneUtils._clearLocalTimezoneCache = function () {
+		sLocalTimezone = "";
+	};
 
 	return TimezoneUtils;
 });