@openui5/sap.ui.core 1.103.1 → 1.106.0

package/src/sap/ui/core/cache/CacheManager.js

@@ -18,7 +18,7 @@ sap.ui.define([
 		/**
 		 * @classdesc
 		 * This object provides persistent caching functionality.
-		 * The component is both private and experimental. It is currently supported to a limited set of environments:
+		 * The component is both private and restricted to framework core usage. It is currently supported to a limited set of environments:
 		 * <ul>
 		 *  <li>Google Chrome(version >=49) for desktop</li>
 		 *  <li>Internet Explorer(version >=11) for desktop.</li>
@@ -55,7 +55,7 @@ sap.ui.define([
 		 * </ul>
 		 * @see sap.ui.core.Configuration
 		 * @private
-		 * @experimental
+		 * @ui5-restricted sap.ui.core
 		 * @since 1.40.0
 		 * @namespace
 		 * @alias sap.ui.core.cache.CacheManager
@@ -129,10 +129,10 @@ sap.ui.define([
 				Log.debug("Cache Manager: Setting value of type[" + typeof value + "] with key [" + key + "]");
 
 				pSet = this._callInstanceMethod("set", arguments).then(function callInstanceHandler() {
-					Log.debug("Cache Manager: Setting key [" + key + "] completed successfully");
+					this.logResolved("set");
 					oMsr.endAsync();
 					//nothing to return, just logging.
-				}, function (e) {
+				}.bind(this), function (e) {
 					Log.error("Cache Manager: Setting key [" + key + "] failed. Error:" + e);
 					oMsr.endAsync();
 					throw e;
@@ -144,11 +144,11 @@ sap.ui.define([
 			/**
 			 * Retrieves a value for given key.
 			 * @param key the key to retrieve a value for
-			 * @returns {Promise} a promise that would be resolved in case of successful operation or rejected with
+			 * @returns {Promise<any|undefined>} a promise that would be resolved in case of successful operation or rejected with
 			 * value of the error message if the operation fails. It resolves with a value that is either:
 			 * <ul>
 			 *  <li>undefined - the entry does not exist</li>
-			 *  <li>any other - the entry exists and value contains the actually one</li>
+			 *  <li>any other - the entry exists and value contains the actual one</li>
 			 * </ul>
 			 * @public
 			 */
@@ -159,10 +159,10 @@ sap.ui.define([
 
 				Log.debug("Cache Manager: Getting key [" + key + "]");
 				pGet = this._callInstanceMethod("get", arguments).then(function callInstanceHandler(v) {
-					Log.debug("Cache Manager: Getting key [" + key + "] done");
+					this.logResolved("get");
 					oMsr.endAsync();
 					return v;
-				}, function (e) {
+				}.bind(this), function (e) {
 					Log.debug("Cache Manager: Getting key [" + key + "] failed. Error: " + e);
 					oMsr.endAsync();
 					throw e;
@@ -184,10 +184,10 @@ sap.ui.define([
 				Log.debug("Cache Manager: has key [" + key + "] called");
 
 				pHas = this._callInstanceMethod("has", arguments).then(function callInstanceHandler(result) {
+					this.logResolved("has");
 					oMsr.endAsync();
-					Log.debug("Cache Manager: has key [" + key + "] returned " + result);
 					return result;
-				});
+				}.bind(this));
 				oMsr.endSync();
 				return pHas;
 			},
@@ -204,10 +204,10 @@ sap.ui.define([
 				Log.debug("Cache Manager: del called.");
 
 				pDel = this._callInstanceMethod("del", arguments).then(function callInstanceHandler() {
-					Log.debug("Cache Manager: del completed successfully.");
+					this.logResolved("del");
 					oMsr.endAsync();
 					//nothing to return, just logging.
-				}, function (e) {
+				}.bind(this), function (e) {
 					Log.debug("Cache Manager: del failed. Error: " + e);
 					oMsr.endAsync();
 					throw e;
@@ -234,8 +234,8 @@ sap.ui.define([
 				Log.debug("Cache Manager: delWithFilters called.");
 
 				pDel = this._callInstanceMethod("delWithFilters", arguments).then(function callInstanceHandler() {
-					Log.debug("Cache Manager: delWithFilters completed successfully.");
-				}, function (e) {
+					this.logResolved("delWithFilters");
+				}.bind(this), function (e) {
 					Log.debug("Cache Manager: delWithFilters failed. Error: " + e);
 					throw e;
 				});
@@ -254,10 +254,10 @@ sap.ui.define([
 				Log.debug("Cache Manager: Reset called.");
 
 				pReset = this._callInstanceMethod("reset", arguments).then(function callInstanceHandler() {
-					Log.debug("Cache Manager: Reset completed successfully.");
+					this.logResolved("reset");
 					oMsr.endAsync();
 					//nothing to return, just logging.
-				}, function (e) {
+				}.bind(this), function (e) {
 					Log.debug("Cache Manager: Reset failed. Error: " + e);
 					oMsr.endAsync();
 					throw e;
@@ -379,6 +379,10 @@ sap.ui.define([
 					});
 				}
 				return this._bSupportedEnvironment;
+			},
+
+			logResolved: function(sFnName) {
+				this._instance.logResolved && this._instance.logResolved(sFnName);
 			}
 		};
 

package/src/sap/ui/core/cache/CacheManagerNOP.js

@@ -4,8 +4,8 @@
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
-sap.ui.define([],
-	function () {
+sap.ui.define(["sap/base/Log"],
+	function (Log) {
 		"use strict";
 
 		/**
@@ -20,6 +20,9 @@ sap.ui.define([],
 		 */
 		var CacheManagerNOP = {
 			name: "CacheManagerNOP",
+			logResolved: function(sFnName) {
+				Log.debug("Cache Manager is not supported on this environment.");
+			},
 			set: function () {
 				return Promise.resolve();
 			},

package/src/sap/ui/core/cache/LRUPersistentCache.js

@@ -4,14 +4,14 @@
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
-sap.ui.define(["sap/base/Log", "sap/ui/performance/Measurement"],
-	function(Log, Measurement) {
+sap.ui.define(["sap/base/Log", "sap/ui/performance/Measurement", "sap/ui/Global"],
+	function(Log, Measurement, Global) {
 		"use strict";
 
 		/**
 		 * @classdesc
 		 * This object provides cache functionality with persistence in IndexedDB.
-		 * The component is an experimental and private.
+		 * The component is private and restricted to the factory class sap.ui.core.cache.CacheManager.
 		 * Do not use outside UI5 framework itself.
 		 * This implementation works with entries corresponding to a single ui5 version.
 		 * If the cache is loaded with different ui5 version, all previous entries will be deleted. The latter behavior is about of a further changes (feature requests)
@@ -20,7 +20,7 @@ sap.ui.define(["sap/base/Log", "sap/ui/performance/Measurement"],
 		 *
 		 * Do not use it directly, use {@link sap.ui.core.cache.CacheManager} instead
 		 * @private
-		 * @experimental
+		 * @ui5-restricted sap.ui.core.cache.CacheManager, sap.ui.core.Configuration
 		 * @since 1.40.0
 		 * @namespace
 		 * @alias sap.ui.core.cache.LRUPersistentCache
@@ -28,6 +28,9 @@ sap.ui.define(["sap/base/Log", "sap/ui/performance/Measurement"],
 
 		var LRUPersistentCache = {
 			name: "LRUPersistentCache",
+			logResolved: function(sFnName) {
+				Log.debug("Cache Manager: " + sFnName + " completed successfully.");
+			},
 
 			defaultOptions: {
 				databaseName: "ui5-cachemanager-db",
@@ -166,8 +169,12 @@ sap.ui.define(["sap/base/Log", "sap/ui/performance/Measurement"],
 					Log.warning("Cache Manager ignored 'has' for key [" + key + "]");
 					return Promise.resolve(false);
 				}
-				return this.get(key).then(function (value) {
-					return typeof value !== "undefined";
+				return this.get(key).then(function(value) {
+					var result = typeof value !== "undefined";
+
+					Log.debug("Cache Manager: has key [" + key + "] returned " + result);
+
+					return result;
 				});
 			},
 
@@ -366,7 +373,7 @@ sap.ui.define(["sap/base/Log", "sap/ui/performance/Measurement"],
 								transaction.abort();
 							};
 							clearMetadataStoreReq.onsuccess = function () {
-								self._metadata = initMetadata(sap.ui.version);
+								self._metadata = initMetadata(Global.version);
 								assignRUCounters(self);
 							};
 						};
@@ -664,7 +671,7 @@ sap.ui.define(["sap/base/Log", "sap/ui/performance/Measurement"],
 		}
 
 		function initIndexedDB(instance) {
-			instance._ui5version = sap.ui.version;
+			instance._ui5version = Global.version;
 			return new Promise(function executorInitIndexedDB(resolve, reject) {
 				var DBOpenRequest;
 

package/src/sap/ui/core/cldr/en.json

@@ -5393,7 +5393,6 @@
 	"weekData-firstDay": 0,
 	"weekData-weekendStart": 6,
 	"weekData-weekendEnd": 0,
-	"weekData-algorithm": "FIRSTDAY_STARTS_FIRSTWEEK",
 	"timeData": {
 		"_allowed": "h hb H hB",
 		"_preferred": "h"

package/src/sap/ui/core/cldr/es_BO.json

@@ -1107,9 +1107,9 @@
 				"yMd": "d/M/y",
 				"yMEd": "E d/M/y",
 				"yMM": "M/y",
-				"yMMM": "MMMM 'de' y",
-				"yMMMd": "d 'de' MMMM 'de' y",
-				"yMMMEd": "E, d 'de' MMM 'de' y",
+				"yMMM": "MMM y",
+				"yMMMd": "d MMM y",
+				"yMMMEd": "E, d MMM y",
 				"yMMMM": "MMMM 'de' y",
 				"yMMMMd": "d 'de' MMMM 'de' y",
 				"yMMMMEd": "EEE, d 'de' MMMM 'de' y",

package/src/sap/ui/core/cldr/es_CL.json

@@ -1107,9 +1107,9 @@
 				"yMd": "dd-MM-y",
 				"yMEd": "E dd-MM-y",
 				"yMM": "M/y",
-				"yMMM": "MMMM 'de' y",
-				"yMMMd": "d 'de' MMMM 'de' y",
-				"yMMMEd": "E, d 'de' MMM 'de' y",
+				"yMMM": "MMM y",
+				"yMMMd": "d MMM y",
+				"yMMMEd": "E, d MMM y",
 				"yMMMM": "MMMM 'de' y",
 				"yMMMMd": "d 'de' MMMM 'de' y",
 				"yMMMMEd": "EEE, d 'de' MMMM 'de' y",

package/src/sap/ui/core/cldr/es_MX.json

@@ -1107,9 +1107,9 @@
 				"yMd": "d/M/y",
 				"yMEd": "E, d/M/y",
 				"yMM": "MM/y",
-				"yMMM": "MMMM 'de' y",
-				"yMMMd": "d 'de' MMMM 'de' y",
-				"yMMMEd": "EEE, d 'de' MMMM 'de' y",
+				"yMMM": "MMM y",
+				"yMMMd": "d MMM y",
+				"yMMMEd": "EEE, d 'de' MMM 'de' y",
 				"yMMMM": "MMMM 'de' y",
 				"yMMMMd": "d 'de' MMMM 'de' y",
 				"yMMMMEd": "EEE, d 'de' MMMM 'de' y",

package/src/sap/ui/core/cldr/es_PE.json

@@ -1107,9 +1107,9 @@
 				"yMd": "d/M/y",
 				"yMEd": "E d/M/y",
 				"yMM": "M/y",
-				"yMMM": "MMMM 'de' y",
-				"yMMMd": "d 'de' MMMM 'de' y",
-				"yMMMEd": "E, d 'de' MMM 'de' y",
+				"yMMM": "MMM y",
+				"yMMMd": "d MMM y",
+				"yMMMEd": "E, d MMM y",
 				"yMMMM": "MMMM 'de' y",
 				"yMMMMd": "d 'de' MMMM 'de' y",
 				"yMMMMEd": "EEE, d 'de' MMMM 'de' y",

package/src/sap/ui/core/cldr/es_UY.json

@@ -1107,9 +1107,9 @@
 				"yMd": "d/M/y",
 				"yMEd": "E d/M/y",
 				"yMM": "M/y",
-				"yMMM": "MMMM 'de' y",
-				"yMMMd": "d 'de' MMMM 'de' y",
-				"yMMMEd": "E, d 'de' MMM 'de' y",
+				"yMMM": "MMM y",
+				"yMMMd": "d MMM y",
+				"yMMMEd": "E, d MMM y",
 				"yMMMM": "MMMM 'de' y",
 				"yMMMMd": "d 'de' MMMM 'de' y",
 				"yMMMMEd": "EEE, d 'de' MMMM 'de' y",

package/src/sap/ui/core/cldr/es_VE.json

@@ -1107,9 +1107,9 @@
 				"yMd": "d/M/y",
 				"yMEd": "E d/M/y",
 				"yMM": "M/y",
-				"yMMM": "MMMM 'de' y",
+				"yMMM": "MMM y",
 				"yMMMd": "d MMM y",
-				"yMMMEd": "E, d 'de' MMM 'de' y",
+				"yMMMEd": "E, d MMM y",
 				"yMMMM": "MMMM 'de' y",
 				"yMMMMd": "d 'de' MMMM 'de' y",
 				"yMMMMEd": "EEE, d 'de' MMMM 'de' y",

package/src/sap/ui/core/date/Buddhist.js

@@ -9,13 +9,21 @@ sap.ui.define(['./UniversalDate', '../CalendarType', './_Calendars'],
 	function(UniversalDate, CalendarType, _Calendars) {
 	"use strict";
 
-
 	/**
 	 * The Buddhist date class
 	 *
 	 * @class
-	 * The Buddhist date implements the Thai solar calendar (BE). In this calendar the year is offset by 543 compared to the
-	 * Gregorian calendar. Before 1941 the year start was 1st of April, so Januar to March belong to the previous year.
+	 * The Buddhist date implements the Thai solar calendar (BE - Buddhist Era). In this calendar
+	 * the year is offset by 543 compared to the Gregorian calendar.
+	 * e.g. Year 2022 CE corresponds to 2565 BE
+	 *
+	 *
+	 * Before 1941 CE the year start was 1st of April, so Januar to March belong to the previous year.
+	 * <pre>
+	 * Month | 1-3 | 4-6 | 7-9 | 10-12 | 1-3 | 4-6 | 7-9 | 10-12 | 1-3 | 4-6 | 7-9 | 10-12 | 1-3 | 4-6 | 7-9 | 10-12 |
+	 * CE    |       1939              |           1940          |         1941            |          1942           |
+	 * BE     2481 |        2482             |      2483         |         2484            |          2485           |
+	 * </pre>
 	 *
 	 * @private
 	 * @alias sap.ui.core.date.Buddhist
@@ -44,8 +52,8 @@ sap.ui.define(['./UniversalDate', '../CalendarType', './_Calendars'],
 	/**
 	 * Find the matching Buddhist date for the given gregorian date
 	 *
-	 * @param {object} oGregorian
-	 * @return {object}
+	 * @param {{year: int, month: int, day: int}} oGregorian Gregorian date
+	 * @return {{year: int, month: int, day: int}} the resulting Buddhist date
 	 */
 	function toBuddhist(oGregorian) {
 		var iEraStartYear = UniversalDate.getEraStartDate(CalendarType.Buddhist, 0).year,
@@ -67,8 +75,8 @@ sap.ui.define(['./UniversalDate', '../CalendarType', './_Calendars'],
 	/**
 	 * Calculate gregorian year from Buddhist year and month
 	 *
-	 * @param {object} oBuddhist
-	 * @return {int}
+	 * @param {{year: int, month: int, day: int}} oBuddhist Buddhist date
+	 * @return {{year: int, month: int, day: int}} the resulting Gregorian date
 	 */
 	function toGregorian(oBuddhist) {
 		var iEraStartYear = UniversalDate.getEraStartDate(CalendarType.Buddhist, 0).year,
@@ -188,12 +196,6 @@ sap.ui.define(['./UniversalDate', '../CalendarType', './_Calendars'],
 		}
 		return this._setUTCBuddhist(oBuddhist);
 	};
-	Buddhist.prototype.getWeek = function() {
-		return UniversalDate.getWeekByDate(this.sCalendarType, this.oDate.getFullYear(), this.getMonth(), this.getDate());
-	};
-	Buddhist.prototype.getUTCWeek = function() {
-		return UniversalDate.getWeekByDate(this.sCalendarType, this.oDate.getUTCFullYear(), this.getUTCMonth(), this.getUTCDate());
-	};
 
 	_Calendars.set(CalendarType.Buddhist, Buddhist);
 

package/src/sap/ui/core/date/Japanese.js

@@ -230,12 +230,6 @@ sap.ui.define(['./UniversalDate', '../CalendarType', './_Calendars'],
 		}
 		return this._setUTCJapanese(oJapanese);
 	};
-	Japanese.prototype.getWeek = function() {
-		return UniversalDate.getWeekByDate(this.sCalendarType, this.oDate.getFullYear(), this.getMonth(), this.getDate());
-	};
-	Japanese.prototype.getUTCWeek = function() {
-		return UniversalDate.getWeekByDate(this.sCalendarType, this.oDate.getUTCFullYear(), this.getUTCMonth(), this.getUTCDate());
-	};
 
 	_Calendars.set(CalendarType.Japanese, Japanese);
 

package/src/sap/ui/core/date/UniversalDate.js

@@ -153,18 +153,64 @@ sap.ui.define(['sap/ui/base/Object', 'sap/ui/core/LocaleData', './_Calendars'],
 	UniversalDate.prototype.setUTCEra = function(iEra) {
 		// The default implementation does not support setting the era
 	};
-	UniversalDate.prototype.getWeek = function() {
-		return UniversalDate.getWeekByDate(this.sCalendarType, this.getFullYear(), this.getMonth(), this.getDate());
+
+	/**
+	 * Retrieves the calendar week
+	 *
+	 * @param {sap.ui.core.Locale} oLocale the locale used to get the calendar week calculation properties, defaults to the formatLocale
+	 * @param {{firstDayOfWeek: int, minimalDaysInFirstWeek: int}} oWeekConfig calendar week calculation parameters,
+	 *   defaults to oLocale but has precedence over oLocale if both are provided.
+	 * @returns {{week: number, year: number}} resulting calendar week, note: week index starts with <code>0</code>
+	 * @private
+	 */
+	UniversalDate.prototype.getWeek = function(oLocale, oWeekConfig) {
+		checkWeekConfig(oWeekConfig);
+		return UniversalDate.getWeekByDate(this.sCalendarType, this.getFullYear(), this.getMonth(), this.getDate(), oLocale, oWeekConfig);
 	};
-	UniversalDate.prototype.setWeek = function(oWeek) {
-		var oDate = UniversalDate.getFirstDateOfWeek(this.sCalendarType, oWeek.year || this.getFullYear(), oWeek.week);
+
+	/**
+	 * Sets the calendar week
+	 *
+	 * @param {{week: number, year: number}} oWeek the calendar week, note: week index starts with <code>0</code>,
+	 *   <code>oWeek.year</code> is optional and defaults to {@link sap.ui.core.date.UniversalDate#getFullYear}
+	 * @param {sap.ui.core.Locale} oLocale the locale used to get the calendar week calculation properties, defaults to the formatLocale
+	 * @param {{firstDayOfWeek: int, minimalDaysInFirstWeek: int}} oWeekConfig calendar week calculation parameters,
+	 *   defaults to oLocale but has precedence over oLocale if both are provided.
+	 * @private
+	 */
+	UniversalDate.prototype.setWeek = function(oWeek, oLocale, oWeekConfig) {
+		checkWeekConfig(oWeekConfig);
+		var oDate = UniversalDate.getFirstDateOfWeek(this.sCalendarType, oWeek.year || this.getFullYear(), oWeek.week, oLocale, oWeekConfig);
 		this.setFullYear(oDate.year, oDate.month, oDate.day);
 	};
-	UniversalDate.prototype.getUTCWeek = function() {
-		return UniversalDate.getWeekByDate(this.sCalendarType, this.getUTCFullYear(), this.getUTCMonth(), this.getUTCDate());
+
+	/**
+	 * Retrieves the UTC calendar week
+	 *
+	 * @param {sap.ui.core.Locale} oLocale the locale used to get the calendar week calculation properties, defaults to the formatLocale
+	 * @param {{firstDayOfWeek: int, minimalDaysInFirstWeek: int}} oWeekConfig calendar week calculation parameters,
+	 *   defaults to oLocale but has precedence over oLocale if both are provided.
+	 * @returns {{week: number, year: number}} resulting calendar week, note: week index starts with <code>0</code>
+	 * @private
+	 */
+	UniversalDate.prototype.getUTCWeek = function(oLocale, oWeekConfig) {
+		checkWeekConfig(oWeekConfig);
+		return UniversalDate.getWeekByDate(this.sCalendarType, this.getUTCFullYear(), this.getUTCMonth(), this.getUTCDate(), oLocale, oWeekConfig);
 	};
-	UniversalDate.prototype.setUTCWeek = function(oWeek) {
-		var oDate = UniversalDate.getFirstDateOfWeek(this.sCalendarType, oWeek.year || this.getFullYear(), oWeek.week);
+
+	/**
+	 * Sets the UTC calendar week
+	 *
+	 * @param {{week: number, year: number}} oWeek the calendar week, note: week index starts with <code>0</code>,
+	 *   <code>oWeek.year</code> is optional and defaults to {@link sap.ui.core.date.UniversalDate#getFullYear}
+	 * @param {sap.ui.core.Locale} oLocale the locale used to get the calendar week calculation properties, defaults to the formatLocale
+	 * @param {{firstDayOfWeek: int, minimalDaysInFirstWeek: int}} oWeekConfig calendar week calculation parameters,
+	 *   defaults to oLocale but has precedence over oLocale if both are provided.
+	 * @private
+	 */
+	UniversalDate.prototype.setUTCWeek = function(oWeek, oLocale, oWeekConfig) {
+		checkWeekConfig(oWeekConfig);
+		var oDate = UniversalDate.getFirstDateOfWeek(this.sCalendarType, oWeek.year || this.getFullYear(), oWeek.week, oLocale, oWeekConfig);
 		this.setUTCFullYear(oDate.year, oDate.month, oDate.day);
 	};
 	UniversalDate.prototype.getQuarter = function() {
@@ -207,22 +253,40 @@ sap.ui.define(['sap/ui/base/Object', 'sap/ui/core/LocaleData', './_Calendars'],
 	 */
 	var iMillisecondsInWeek = 7 * 24 * 60 * 60 * 1000;
 
-	UniversalDate.getWeekByDate = function(sCalendarType, iYear, iMonth, iDay) {
-		var oLocale = sap.ui.getCore().getConfiguration().getFormatSettings().getFormatLocale(),
-			oLocaleData = LocaleData.getInstance(oLocale),
-			clDate = this.getClass(sCalendarType),
-			oFirstDay = getFirstDayOfFirstWeek(clDate, iYear),
-			oDate = new clDate(clDate.UTC(iYear, iMonth, iDay)),
-			iWeek, iLastYear, iNextYear, oLastFirstDay, oNextFirstDay;
+	/**
+	 * Retrieves the calendar week for a given date, specified by year, month, and day.
+	 *
+	 * @param {string} sCalendarType the calendar type, e.g. <code>"Gregorian"</code>
+	 * @param {int} iYear year, e.g. <code>2016</code>
+	 * @param {int} iMonth the month, e.g. <code>2</code>
+	 * @param {int} iDay the date, e.g. <code>3</code>
+	 * @param {sap.ui.core.Locale} [oLocale] the locale used for the week calculation, if oWeekConfig is not provided (falls back to the formatLocale)
+	 *   e.g. <code>new Locale("de-DE")</code>
+	 * @param {{firstDayOfWeek: int, minimalDaysInFirstWeek: int}} [oWeekConfig] calendar week calculation parameters,
+	 *   defaults to oLocale but has precedence over oLocale if both are provided.
+	 *   Both properties firstDayOfWeek and minimalDaysInFirstWeek must be provided, otherwise it will be ignored.
+	 *   If provided US split week is ignored.
+	 *   e.g. <code>{firstDayOfWeek: 1, minimalDaysInFirstWeek: 4}</code>
+	 * @returns {{week: number, year: number}} resulting calendar week, note: week index starts with <code>0</code>, e.g. <code>{year: 2016, week: 8}</code>
+	 * @private
+	 */
+	UniversalDate.getWeekByDate = function(sCalendarType, iYear, iMonth, iDay, oLocale, oWeekConfig) {
+		oLocale = oLocale || sap.ui.getCore().getConfiguration().getFormatSettings().getFormatLocale();
+		var oLocaleData = LocaleData.getInstance(oLocale);
+		var clDate = this.getClass(sCalendarType);
+		var oFirstDay = getFirstDayOfFirstWeek(clDate, iYear, oLocale, oWeekConfig);
+		var oDate = new clDate(clDate.UTC(iYear, iMonth, iDay));
+		var iWeek, iLastYear, iNextYear, oLastFirstDay, oNextFirstDay;
 		// If region is US, always calculate the week for the current year, otherwise
 		// the week might be the last week of the previous year or first week of next year
-		if (oLocaleData.firstDayStartsFirstWeek()) {
+		var bSplitWeek = (!oWeekConfig || oWeekConfig.minimalDaysInFirstWeek === undefined || oWeekConfig.firstDayOfWeek === undefined) && oLocaleData.firstDayStartsFirstWeek();
+		if (bSplitWeek) {
 			iWeek = calculateWeeks(oFirstDay, oDate);
 		} else {
 			iLastYear = iYear - 1;
 			iNextYear = iYear + 1;
-			oLastFirstDay = getFirstDayOfFirstWeek(clDate, iLastYear);
-			oNextFirstDay = getFirstDayOfFirstWeek(clDate, iNextYear);
+			oLastFirstDay = getFirstDayOfFirstWeek(clDate, iLastYear, oLocale, oWeekConfig);
+			oNextFirstDay = getFirstDayOfFirstWeek(clDate, iNextYear, oLocale, oWeekConfig);
 			if (oDate >= oNextFirstDay) {
 				iYear = iNextYear;
 				iWeek = 0;
@@ -239,17 +303,32 @@ sap.ui.define(['sap/ui/base/Object', 'sap/ui/core/LocaleData', './_Calendars'],
 		};
 	};
 
-	UniversalDate.getFirstDateOfWeek = function(sCalendarType, iYear, iWeek) {
-		var oLocale = sap.ui.getCore().getConfiguration().getFormatSettings().getFormatLocale(),
-			oLocaleData = LocaleData.getInstance(oLocale),
-			clDate = this.getClass(sCalendarType),
-			oFirstDay = getFirstDayOfFirstWeek(clDate, iYear),
-			oDate = new clDate(oFirstDay.valueOf() + iWeek * iMillisecondsInWeek),
-			bIsRegionUS = oLocaleData.firstDayStartsFirstWeek();
+	/**
+	 * Retrieves the first day's date of the given week in the given year.
+	 *
+	 * @param {string} sCalendarType the calendar type, e.g. <code>"Gregorian"</code>
+	 * @param {int} iYear year, e.g. <code>2016</code>
+	 * @param {int} iWeek the calendar week index, e.g. <code>8</code>
+	 * @param {sap.ui.core.Locale} [oLocale] the locale used for the week calculation, if oWeekConfig is not provided (falls back to the formatLocale)
+	 *   e.g. <code>new Locale("de-DE")</code>
+	 * @param {{firstDayOfWeek: int, minimalDaysInFirstWeek: int}} [oWeekConfig] calendar week calculation parameters,
+	 *   defaults to oLocale but has precedence over oLocale if both are provided.
+	 *   Both properties firstDayOfWeek and minimalDaysInFirstWeek must be provided, otherwise it will be ignored.
+	 *   If provided US split week is ignored.
+	 *   e.g. <code>{firstDayOfWeek: 1, minimalDaysInFirstWeek: 4}</code>
+	 * @returns {{month: number, year: number, day: number}} the resulting date, e.g. <code>{year: 2016, month: 1, day: 29}</code>
+	 * @private
+	 */
+	UniversalDate.getFirstDateOfWeek = function(sCalendarType, iYear, iWeek, oLocale, oWeekConfig) {
+		oLocale = oLocale || sap.ui.getCore().getConfiguration().getFormatSettings().getFormatLocale();
+		var oLocaleData = LocaleData.getInstance(oLocale);
+		var clDate = this.getClass(sCalendarType);
+		var oFirstDay = getFirstDayOfFirstWeek(clDate, iYear, oLocale, oWeekConfig);
+		var oDate = new clDate(oFirstDay.valueOf() + iWeek * iMillisecondsInWeek);
 		//If first day of week is in last year and region is US, return the
 		//1st of January instead for symmetric behaviour
-
-		if (bIsRegionUS && iWeek === 0 && oFirstDay.getUTCFullYear() < iYear) {
+		var bSplitWeek = (!oWeekConfig || oWeekConfig.minimalDaysInFirstWeek === undefined || oWeekConfig.firstDayOfWeek === undefined) && oLocaleData.firstDayStartsFirstWeek();
+		if (bSplitWeek && iWeek === 0 && oFirstDay.getUTCFullYear() < iYear) {
 			return {
 				year: iYear,
 				month: 0,
@@ -263,13 +342,44 @@ sap.ui.define(['sap/ui/base/Object', 'sap/ui/core/LocaleData', './_Calendars'],
 		};
 	};
 
-	function getFirstDayOfFirstWeek(clDate, iYear) {
-		var oLocale = sap.ui.getCore().getConfiguration().getFormatSettings().getFormatLocale(),
-			oLocaleData = LocaleData.getInstance(oLocale),
-			iMinDays = oLocaleData.getMinimalDaysInFirstWeek(),
-			iFirstDayOfWeek = oLocaleData.getFirstDayOfWeek(),
-			oFirstDay = new clDate(clDate.UTC(iYear, 0, 1)),
-			iDayCount = 7;
+	function checkWeekConfig(oWeekConfig) {
+		if (oWeekConfig) {
+			if (oWeekConfig.firstDayOfWeek === undefined && oWeekConfig.minimalDaysInFirstWeek !== undefined
+			|| oWeekConfig.firstDayOfWeek !== undefined && oWeekConfig.minimalDaysInFirstWeek === undefined) {
+				throw new Error("Week config requires both firstDayOfWeek and minimalDaysInFirstWeek to be set");
+			}
+		}
+	}
+
+	/**
+	 * Returns the first day of the first week in the given year.
+	 *
+	 * @param {UniversalDate} clDate the date class
+	 * @param {int} iYear year, e.g. <code>2016</code>
+	 * @param {sap.ui.core.Locale} [oLocale] the locale used for the week calculation, if oWeekConfig is not provided (falls back to the formatLocale)
+	 *   e.g. <code>new Locale("de-DE")</code>
+	 * @param {{firstDayOfWeek: int, minimalDaysInFirstWeek: int}} [oWeekConfig] calendar week calculation parameters,
+	 *   defaults to oLocale but has precedence over oLocale if both are provided.
+	 *   Both properties firstDayOfWeek and minimalDaysInFirstWeek must be provided, otherwise it will be ignored.
+	 *   If provided US split week is ignored.
+	 *   e.g. <code>{firstDayOfWeek: 1, minimalDaysInFirstWeek: 4}</code>
+	 * @returns {Date} first day of the first week in the given year, e.g. <code>Mon Jan 04 2016 01:00:00 GMT+0100</code>
+	 * @private
+	 */
+	function getFirstDayOfFirstWeek(clDate, iYear, oLocale, oWeekConfig) {
+		oLocale = oLocale || sap.ui.getCore().getConfiguration().getFormatSettings().getFormatLocale();
+		var oLocaleData = LocaleData.getInstance(oLocale);
+		var iMinDays;
+		var iFirstDayOfWeek;
+		if (oWeekConfig && oWeekConfig.minimalDaysInFirstWeek !== undefined && oWeekConfig.firstDayOfWeek !== undefined) {
+			iMinDays = oWeekConfig.minimalDaysInFirstWeek;
+			iFirstDayOfWeek = oWeekConfig.firstDayOfWeek;
+		} else {
+			iMinDays = oLocaleData.getMinimalDaysInFirstWeek();
+			iFirstDayOfWeek = oLocaleData.getFirstDayOfWeek();
+		}
+		var oFirstDay = new clDate(clDate.UTC(iYear, 0, 1));
+		var iDayCount = 7;
 
 		if (isNaN(oFirstDay.getTime())) {
 			throw new Error("Could not determine the first day of the week, because the date " +

package/src/sap/ui/core/delegate/ItemNavigation.js

@@ -81,7 +81,7 @@ sap.ui.define([
 	 * @param {Element[]} aItemDomRefs Array of DOM references representing the items for the navigation
 	 * @param {boolean} [bNotInTabChain=false] Whether the selected element should be in the tab chain or not
 	 *
-	 * @version 1.103.1
+	 * @version 1.106.0
 	 * @alias sap.ui.core.delegate.ItemNavigation
 	 * @public
 	 */
@@ -257,7 +257,7 @@ sap.ui.define([
 	/**
 	 * Sets the root DOM reference surrounding the items
 	 *
-	 * @param {object} oDomRef Root DOM reference
+	 * @param {Element} oDomRef Root DOM reference
 	 * @return {this} <code>this</code> to allow method chaining
 	 * @public
 	 */

package/src/sap/ui/core/delegate/ScrollEnablement.js

@@ -58,7 +58,7 @@ sap.ui.define([
 		 *
 		 * @protected
 		 * @alias sap.ui.core.delegate.ScrollEnablement
-		 * @version 1.103.1
+		 * @version 1.106.0
 		 * @author SAP SE
 		 */
 		var ScrollEnablement = BaseObject.extend("sap.ui.core.delegate.ScrollEnablement", /** @lends sap.ui.core.delegate.ScrollEnablement.prototype */ {
@@ -226,7 +226,7 @@ sap.ui.define([
 			 * @param {int} [time=0]
 			 *           The duration of animated scrolling in milliseconds. To scroll immediately without animation,
 			 *           give 0 as value.
-			 * @param {function} fnScrollEndCallback
+			 * @param {function} fnScrollEndCallback Called when the scroll completes or stops without completing
 			 * @returns {this}
 			 * @public
 			 */
@@ -785,10 +785,11 @@ sap.ui.define([
 			_scrollTo: function(x, y, time, fnScrollEndCallback) {
 				if (this._$Container.length > 0) {
 					if (time > 0) {
-						this._$Container.finish().animate({ scrollTop: y, scrollLeft: x }, time, function() {
-							this._readActualScrollPosition();
-							fnScrollEndCallback && fnScrollEndCallback();
-						}.bind(this));
+						this._$Container.finish().animate({ scrollTop: y, scrollLeft: x }, {
+							duration: time,
+							complete: this._readActualScrollPosition.bind(this),
+							always: fnScrollEndCallback
+						});
 					} else {
 						this._$Container.scrollTop(y);
 						this._$Container.scrollLeft(x);