@openui5/sap.ui.core 1.112.2 → 1.114.0

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

@@ -47,17 +47,20 @@ sap.ui.define([
 	 * @class A date implementation considering the configured time zone
 	 *
 	 *   A subclass of JavaScript <code>Date</code> that considers the configured time zone, see
-	 *   {@link sap.ui.core.Configuration.getTimezone}. All JavaScript <code>Date</code> functions
+	 *   {@link sap.ui.core.Configuration#getTimezone}. All JavaScript <code>Date</code> functions
 	 *   that use the local browser time zone, like <code>getDate</code>,
 	 *   <code>setDate</code>, and <code>toString</code>, are overwritten and use the
 	 *   configured time zone to compute the values.
 	 *
 	 *   Use {@link module:sap/ui/core/date/UI5Date.getInstance} to create new date instances.
 	 *
+	 *   <b>Note:</b> Adjusting the time zone in a running application can lead to unexpected data
+	 *   inconsistencies. For more information, see {@link sap.ui.core.Configuration#setTimezone}.
+	 *
 	 * @hideconstructor
 	 * @public
 	 * @since 1.111.0
-	 * @version 1.112.2
+	 * @version 1.114.0
 	 */
 	function UI5Date(vDateParts, sTimezoneID) {
 		var oDateInstance = UI5Date._createDateInstance(vDateParts);
@@ -940,20 +943,23 @@ sap.ui.define([
 	 * in <code>getDate</code>, <code>toString</code>, or <code>setHours</code>. The supported
 	 * parameters are the same as the ones supported by the JavaScript Date constructor.
 	 *
+	 * <b>Note:</b> Adjusting the time zone in a running application can lead to unexpected data
+	 * inconsistencies. For more information, see {@link sap.ui.core.Configuration#setTimezone}.
+	 *
 	 * @param {int|string|Date|module:sap/ui/core/date/UI5Date|null} [vYearOrValue]
 	 *   Same meaning as in the JavaScript Date constructor
 	 * @param {int|string} [vMonthIndex]
 	 *   Same meaning as in the JavaScript Date constructor
-	 * @param {int|string} [vDay=1] Same meaning as in the Date constructor
-	 * @param {int|string} [vHours=0] Same meaning as in the Date constructor
-	 * @param {int|string} [vMinutes=0] Same meaning as in the Date constructor
-	 * @param {int|string} [vSeconds=0] Same meaning as in the Date constructor
-	 * @param {int|string} [vMilliseconds=0] Same meaning as in the Date constructor
+	 * @param {int|string} [vDay=1] Same meaning as in the JavaScript Date constructor
+	 * @param {int|string} [vHours=0] Same meaning as in the JavaScript Date constructor
+	 * @param {int|string} [vMinutes=0] Same meaning as in the JavaScript Date constructor
+	 * @param {int|string} [vSeconds=0] Same meaning as in the JavaScript Date constructor
+	 * @param {int|string} [vMilliseconds=0] Same meaning as in the JavaScript Date constructor
 	 * @returns {Date|module:sap/ui/core/date/UI5Date}
 	 *   The date instance that considers the configured time zone in all local getters and setters.
 	 *
 	 * @public
-	 * @see sap.ui.core.Configuration.getTimezone
+	 * @see sap.ui.core.Configuration#getTimezone
 	 */
 	UI5Date.getInstance = function () {
 		var sTimezone = Configuration.getTimezone();

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

@@ -810,7 +810,6 @@ sap.ui.define([
 	 * </ul>
 	 */
 	UniversalDate.prototype.getWeek = function(oLocale, vCalendarWeekNumbering) {
-		checkWeekConfig(vCalendarWeekNumbering);
 		return UniversalDate.getWeekByDate(this.sCalendarType, this.getFullYear(), this.getMonth(), this.getDate(), oLocale, vCalendarWeekNumbering);
 	};
 
@@ -835,7 +834,6 @@ sap.ui.define([
 	 * </ul>
 	 */
 	UniversalDate.prototype.setWeek = function(oWeek, oLocale, vCalendarWeekNumbering) {
-		checkWeekConfig(vCalendarWeekNumbering);
 		var oDate = UniversalDate.getFirstDateOfWeek(this.sCalendarType, oWeek.year || this.getFullYear(), oWeek.week, oLocale, vCalendarWeekNumbering);
 		this.setFullYear(oDate.year, oDate.month, oDate.day);
 	};
@@ -860,7 +858,6 @@ sap.ui.define([
 	 * </ul>
 	 */
 	UniversalDate.prototype.getUTCWeek = function(oLocale, vCalendarWeekNumbering) {
-		checkWeekConfig(vCalendarWeekNumbering);
 		return UniversalDate.getWeekByDate(this.sCalendarType, this.getUTCFullYear(), this.getUTCMonth(), this.getUTCDate(), oLocale, vCalendarWeekNumbering);
 	};
 
@@ -885,7 +882,6 @@ sap.ui.define([
 	 * </ul>
 	 */
 	UniversalDate.prototype.setUTCWeek = function(oWeek, oLocale, vCalendarWeekNumbering) {
-		checkWeekConfig(vCalendarWeekNumbering);
 		var oDate = UniversalDate.getFirstDateOfWeek(this.sCalendarType, oWeek.year || this.getFullYear(), oWeek.week, oLocale, vCalendarWeekNumbering);
 		this.setUTCFullYear(oDate.year, oDate.month, oDate.day);
 	};
@@ -1016,6 +1012,7 @@ sap.ui.define([
 	 * </ul>
 	 */
 	UniversalDate.getWeekByDate = function(sCalendarType, iYear, iMonth, iDay, oLocale, vCalendarWeekNumbering) {
+		vCalendarWeekNumbering = vCalendarWeekNumbering || Configuration.getCalendarWeekNumbering();
 		checkWeekConfig(vCalendarWeekNumbering);
 		oLocale = oLocale || Configuration.getFormatSettings().getFormatLocale();
 		var clDate = this.getClass(sCalendarType);
@@ -1070,6 +1067,7 @@ sap.ui.define([
 	 * </ul>
 	 */
 	UniversalDate.getFirstDateOfWeek = function(sCalendarType, iYear, iWeek, oLocale, vCalendarWeekNumbering) {
+		vCalendarWeekNumbering = vCalendarWeekNumbering || Configuration.getCalendarWeekNumbering();
 		checkWeekConfig(vCalendarWeekNumbering);
 		oLocale = oLocale || Configuration.getFormatSettings().getFormatLocale();
 		var clDate = this.getClass(sCalendarType);
@@ -1094,77 +1092,52 @@ sap.ui.define([
 	 * Determines if the split week algorithm should be applied (the first day of the first calendar
 	 * week of the year is January 1st).
 	 *
-	 * @param {sap.ui.core.date.CalendarWeekNumbering|{firstDayOfWeek: int, minimalDaysInFirstWeek: int}} [vCalendarWeekNumbering]
+	 * @param {sap.ui.core.date.CalendarWeekNumbering|{firstDayOfWeek: int, minimalDaysInFirstWeek: int}} vCalendarWeekNumbering
 	 *   calendar week numbering or object with fields <code>firstDayOfWeek</code> and
 	 *   <code>minimalDaysInFirstWeek</code>
-	 * @param {sap.ui.core.Locale} [oLocale] the locale used for the week calculation
+	 * @param {sap.ui.core.Locale} oLocale the locale used for the week calculation
 	 * @returns {boolean} if the split week should be applied
-	 * @private
-	 * @ui5-restricted SAPUI5 Distribution Layer Libraries
 	 */
 	function isSplitWeek(vCalendarWeekNumbering, oLocale) {
-		oLocale = oLocale || Configuration.getFormatSettings().getFormatLocale();
 		var oLocaleData = LocaleData.getInstance(oLocale);
-		return (!isCalendarWeekConfigurationDefined(vCalendarWeekNumbering) ||
-			vCalendarWeekNumbering === CalendarWeekNumbering.Default)
+
+		// only applies for en_US with default CalendarWeekNumbering (WesternTraditional is default in en_US)
+		return (vCalendarWeekNumbering === CalendarWeekNumbering.Default
+				|| vCalendarWeekNumbering === CalendarWeekNumbering.WesternTraditional)
 			&& oLocaleData.firstDayStartsFirstWeek();
 	}
 
 	/**
 	 * Checks the calendar week configuration
 	 *
-	 * @param {sap.ui.core.date.CalendarWeekNumbering|{firstDayOfWeek: int, minimalDaysInFirstWeek: int}} [vCalendarWeekNumbering]
+	 * @param {sap.ui.core.date.CalendarWeekNumbering|{firstDayOfWeek: int, minimalDaysInFirstWeek: int}} vCalendarWeekNumbering
 	 *   calendar week numbering or object with fields <code>firstDayOfWeek</code> and <code>minimalDaysInFirstWeek</code>
 	 * @throws {TypeError} If:
 	 * <ul>
 	 *   <li>vCalendarWeekNumbering is an object and the fields <code>firstDayOfWeek</code> or <code>minimalDaysInFirstWeek</code>) are missing or have a non-numeric value</li>
 	 *   <li>vCalendarWeekNumbering is a string and has an invalid week numbering value</li>
 	 * </ul>
-	 * @private
-	 * @ui5-restricted SAPUI5 Distribution Layer Libraries
 	 */
 	function checkWeekConfig(vCalendarWeekNumbering) {
 		if (typeof vCalendarWeekNumbering === "object") {
-			if (!isCalendarWeekConfigurationDefined(vCalendarWeekNumbering)) {
+			if (typeof vCalendarWeekNumbering.firstDayOfWeek !== "number"
+					|| typeof vCalendarWeekNumbering.minimalDaysInFirstWeek !== "number") {
 				throw new TypeError("Week config requires firstDayOfWeek and minimalDaysInFirstWeek to be set");
 			}
-		} else if (vCalendarWeekNumbering && !Object.values(CalendarWeekNumbering).includes(vCalendarWeekNumbering)) {
+		} else if (!Object.values(CalendarWeekNumbering).includes(vCalendarWeekNumbering)) {
 			throw new TypeError("Illegal format option calendarWeekNumbering: '" + vCalendarWeekNumbering + "'");
 		}
 	}
 
-	/**
-	 * Checks if the calendar week configuration is defined
-	 *
-	 * @param {sap.ui.core.date.CalendarWeekNumbering|{firstDayOfWeek: int, minimalDaysInFirstWeek: int}} [vCalendarWeekNumbering]
-	 *   the parameter which is checked
-	 * @returns {boolean} if the parameter vCalendarWeekNumbering is defined and in case of an
-	 *   object has the required properties <code>firstDayOfWeek</code> and
-	 *   <code>minimalDaysInFirstWeek</code> defined with a numeric value
-	 * @private
-	 * @ui5-restricted SAPUI5 Distribution Layer Libraries
-	 */
-	function isCalendarWeekConfigurationDefined (vCalendarWeekNumbering) {
-		if (typeof vCalendarWeekNumbering === "object") {
-			return typeof vCalendarWeekNumbering.firstDayOfWeek === "number"
-				&& typeof vCalendarWeekNumbering.minimalDaysInFirstWeek === "number";
-		} else if (vCalendarWeekNumbering) {
-			return true;
-		}
-		return false;
-	}
-
 	/**
 	 * Resolves the calendar week configuration
 	 *
-	 * @param {sap.ui.core.date.CalendarWeekNumbering|{firstDayOfWeek: int, minimalDaysInFirstWeek: int}} [vCalendarWeekNumbering]
+	 * @param {sap.ui.core.date.CalendarWeekNumbering|{firstDayOfWeek: int, minimalDaysInFirstWeek: int}} vCalendarWeekNumbering
 	 *   calendar week numbering or object with fields <code>firstDayOfWeek</code> and <code>minimalDaysInFirstWeek</code>
 	 * @param {sap.ui.core.Locale} [oLocale] locale to be used
 	 * @returns {{firstDayOfWeek: int, minimalDaysInFirstWeek: int}} calendar week calculation configuration
-	 * @private
-	 * @ui5-restricted SAPUI5 Distribution Layer Libraries
 	 */
-	 function resolveCalendarWeekConfiguration (vCalendarWeekNumbering, oLocale) {
+	function resolveCalendarWeekConfiguration (vCalendarWeekNumbering, oLocale) {
 		// be backward compatible
 		if (typeof vCalendarWeekNumbering === "object"
 				&& typeof vCalendarWeekNumbering.firstDayOfWeek === "number"
@@ -1181,13 +1154,11 @@ sap.ui.define([
 	 * @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 {sap.ui.core.date.CalendarWeekNumbering|{firstDayOfWeek: int, minimalDaysInFirstWeek: int}} [vCalendarWeekNumbering]
+	 * @param {sap.ui.core.date.CalendarWeekNumbering|{firstDayOfWeek: int, minimalDaysInFirstWeek: int}} vCalendarWeekNumbering
 	 *   calendar week numbering or object with fields <code>firstDayOfWeek</code> and <code>minimalDaysInFirstWeek</code>,
 	 *   the default is derived from <code>oLocale</code> but this parameter has precedence over oLocale if both are provided.
 	 *   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
-	 * @ui5-restricted SAPUI5 Distribution Layer Libraries
 	 */
 	function getFirstDayOfFirstWeek(clDate, iYear, oLocale, vCalendarWeekNumbering) {
 		oLocale = oLocale || Configuration.getFormatSettings().getFormatLocale();
@@ -1221,9 +1192,6 @@ sap.ui.define([
 	 * @param {Date} oFromDate The beginning date of the time interval
 	 * @param {Date} oToDate The end date of the time interval
 	 * @returns {int} A rounded number which represents the amount of weeks in the given timer interval
-	 *
-	 * @private
-	 * @ui5-restricted SAPUI5 Distribution Layer Libraries
 	 */
 	function calculateWeeks(oFromDate, oToDate) {
 		return Math.floor((oToDate.valueOf() - oFromDate.valueOf()) / iMillisecondsInWeek);
@@ -1310,9 +1278,6 @@ sap.ui.define([
 	 *   The calender type from which the the locale era data is taken from and the era array is
 	 *   generated
 	 * @returns {array} An array of all available era in the given calender
-	 *
-	 * @private
-	 * @ui5-restricted SAPUI5 Distribution Layer Libraries
 	 */
 	function getEras(sCalendarType) {
 		var oLocale = Configuration.getFormatSettings().getFormatLocale(),
@@ -1349,9 +1314,6 @@ sap.ui.define([
 	 * @returns {object}
 	 *   An object containing the year, month, day of month and date timestamp values of the given
 	 *   date string
-	 *
-	 * @private
-	 * @ui5-restricted SAPUI5 Distribution Layer Libraries
 	 */
 	function parseDateString(sDateString) {
 		var aParts = sDateString.split("-"),

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

@@ -391,11 +391,11 @@ sap.ui.define([
 		 */
 		 UniversalDateUtils._getDateFromWeekStartByDayOffset = function (sCalendarWeekNumbering, iDaysToAdd) {
 			var sCalendarType = Configuration.getCalendarType(),
-				oLocale = new Locale(Configuration.getFormatLocale()),
+				oLocale = Configuration.getFormatSettings().getFormatLocale(),
 				oUniversalDate = UniversalDateUtils.createNewUniversalDate(),
-				iWeek = oUniversalDate.getWeek().week,
-				iYear = oUniversalDate.getWeek().year,
-				oFirstDateOfWeek = UniversalDate.getFirstDateOfWeek(sCalendarType, iYear, iWeek, oLocale, sCalendarWeekNumbering);
+				oWeekAndYear = oUniversalDate.getWeek(oLocale, sCalendarWeekNumbering),
+				oFirstDateOfWeek = UniversalDate.getFirstDateOfWeek(sCalendarType, oWeekAndYear.year, oWeekAndYear.week,
+						oLocale, sCalendarWeekNumbering);
 
 			if (iDaysToAdd === undefined) {
 				iDaysToAdd = 0;

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

@@ -17,7 +17,7 @@ sap.ui.define([], function () {
 	var _Calendars = {
 		get: function (sCalendarType) {
 			if (!mRegistry.has(sCalendarType)) {
-				sap.ui.requireSync("sap/ui/core/date/" + sCalendarType);
+				sap.ui.requireSync("sap/ui/core/date/" + sCalendarType); // TODO: establish full async alternative
 			}
 
 			return mRegistry.get(sCalendarType);

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.112.2
+	 * @version 1.114.0
 	 * @alias sap.ui.core.delegate.ItemNavigation
 	 * @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.112.2
+		 * @version 1.114.0
 		 * @author SAP SE
 		 */
 		var ScrollEnablement = BaseObject.extend("sap.ui.core.delegate.ScrollEnablement", /** @lends sap.ui.core.delegate.ScrollEnablement.prototype */ {

package/src/sap/ui/core/dnd/DragDropBase.js

@@ -37,7 +37,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.core.Element
 	 * @author SAP SE
-	 * @version 1.112.2
+	 * @version 1.114.0
 	 *
 	 * @public
 	 * @since 1.52

package/src/sap/ui/core/dnd/DragDropInfo.js

@@ -22,7 +22,7 @@ sap.ui.define(["./DragInfo", "./DropInfo", "sap/base/Log"],
 	 * @extends sap.ui.core.dnd.DropInfo
 	 *
 	 * @author SAP SE
-	 * @version 1.112.2
+	 * @version 1.114.0
 	 *
 	 * @public
 	 * @since 1.52

package/src/sap/ui/core/dnd/DragInfo.js

@@ -22,7 +22,7 @@ sap.ui.define(["./DragDropBase"],
 	 * @extends sap.ui.core.dnd.DragDropBase
 	 *
 	 * @author SAP SE
-	 * @version 1.112.2
+	 * @version 1.114.0
 	 *
 	 * @public
 	 * @since 1.56

package/src/sap/ui/core/dnd/DropInfo.js

@@ -21,7 +21,7 @@ sap.ui.define(["./DragDropBase"],
 	 * @extends sap.ui.core.dnd.DragDropBase
 	 *
 	 * @author SAP SE
-	 * @version 1.112.2
+	 * @version 1.114.0
 	 *
 	 * @public
 	 * @since 1.56