@openui5/sap.ui.core 1.104.0 → 1.105.1

package/src/sap/ui/core/UIArea.js

@@ -175,7 +175,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.104.0
+	 * @version 1.105.1
 	 * @param {sap.ui.core.Core} oCore internal API of the <core>Core</code> that manages this UIArea
 	 * @param {object} [oRootNode] reference to the DOM element that should be 'hosting' the UI Area.
 	 * @public

package/src/sap/ui/core/UIComponent.js

@@ -54,7 +54,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Component
 	 * @abstract
 	 * @author SAP SE
-	 * @version 1.104.0
+	 * @version 1.105.1
 	 * @alias sap.ui.core.UIComponent
 	 * @since 1.9.2
 	 * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel

package/src/sap/ui/core/UIComponentMetadata.js

@@ -18,7 +18,7 @@ sap.ui.define(['./ComponentMetadata', 'sap/ui/core/mvc/ViewType'],
 	 * @experimental Since 1.15.1. The Component concept is still under construction, so some implementation details can be changed in future.
 	 * @class
 	 * @author SAP SE
-	 * @version 1.104.0
+	 * @version 1.105.1
 	 * @since 1.15.1
 	 * @alias sap.ui.core.UIComponentMetadata
 	 * @extends sap.ui.core.ComponentMetadata

package/src/sap/ui/core/ValueStateSupport.js

@@ -16,7 +16,7 @@ sap.ui.define(['./Element', './library', "sap/base/assert"],
 		 * Helper functionality for value state support.
 		 *
 		 * @author SAP SE
-		 * @version 1.104.0
+		 * @version 1.105.1
 		 * @public
 		 * @namespace sap.ui.core.ValueStateSupport
 		 */

package/src/sap/ui/core/VariantLayoutData.js

@@ -20,7 +20,7 @@ sap.ui.define(['./LayoutData', './library'],
 	 * @class
 	 * Allows to add multiple LayoutData to one control in case that an easy switch of layouts (e.g. in a Form) is needed.
 	 * @extends sap.ui.core.LayoutData
-	 * @version 1.104.0
+	 * @version 1.105.1
 	 *
 	 * @public
 	 * @since 1.9.2

package/src/sap/ui/core/XMLComposite.js

@@ -136,6 +136,9 @@ sap.ui.define([
 		 *    }
 		 * </pre>
 		 *
+		 * <b>Note:</b> {@link topic:b11d853a8e784db6b2d210ef57b0f7d7 Requiring modules in XML} will result in side effects that might cause the XMLComposite to not work properly.
+		 * We suggest you require the needed modules inside the JavaScript coding of the class extending the XMLComposite.
+		 *
 		 * @see sap.ui.core.Control
 		 * @see sap.ui.core.Fragment
 		 *
@@ -143,7 +146,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.104.0
+		 * @version 1.105.1
 		 * @since 1.56.0
 		 * @alias sap.ui.core.XMLComposite
 		 * @see {@link topic:b83a4dcb7d0e46969027345b8d32fd44 XML Composite Controls}

package/src/sap/ui/core/XMLCompositeMetadata.js

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * @param {object} oClassInfo static info to construct the metadata from
 	 *
 	 * @author SAP SE
-	 * @version 1.104.0
+	 * @version 1.105.1
 	 * @since 1.50.0
 	 * @alias sap.ui.core.XMLCompositeMetadata
 	 * @extends sap.ui.core.ElementMetadata

package/src/sap/ui/core/_IconRegistry.js

@@ -723,7 +723,7 @@ sap.ui.define([
 				'heart-2': 0xe294,
 				'paint-bucket': 0xe29b,
 				'tri-state': 0xe295,
-				'binary': 0xe29d,
+				'non-binary': 0xe29d,
 				'direction-arrows': 0xe29c,
 				'female': 0xe29e,
 				'gender-male-and-female': 0x1e300,

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

@@ -52,8 +52,8 @@ sap.ui.define(['./UniversalDate', '../CalendarType', './_Calendars'],
 	/**
 	 * Find the matching Buddhist date for the given gregorian date
 	 *
-	 * @param {{year:int,month:int,day:int}} oGregorian Gregorian date
-	 * @return {{year:int,month:int,day:int}} the resulting Buddhist date
+	 * @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,
@@ -75,8 +75,8 @@ sap.ui.define(['./UniversalDate', '../CalendarType', './_Calendars'],
 	/**
 	 * Calculate gregorian year from Buddhist year and month
 	 *
-	 * @param {{year:int,month:int,day:int}} oBuddhist Buddhist date
-	 * @return {{year:int,month:int,day:int}} the resulting Gregorian date
+	 * @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,

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.104.0
+	 * @version 1.105.1
 	 * @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.104.0
+		 * @version 1.105.1
 		 * @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.104.0
+	 * @version 1.105.1
 	 *
 	 * @public
 	 * @since 1.52

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

@@ -4,8 +4,8 @@
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
-sap.ui.define(["./DragInfo", "./DropInfo", "sap/ui/Device", "sap/base/Log"],
-	function(DragInfo, DropInfo, Device, Log) {
+sap.ui.define(["./DragInfo", "./DropInfo", "sap/base/Log"],
+	function(DragInfo, DropInfo, Log) {
 	"use strict";
 
 	/**
@@ -22,7 +22,7 @@ sap.ui.define(["./DragInfo", "./DropInfo", "sap/ui/Device", "sap/base/Log"],
 	 * @extends sap.ui.core.dnd.DropInfo
 	 *
 	 * @author SAP SE
-	 * @version 1.104.0
+	 * @version 1.105.1
 	 *
 	 * @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.104.0
+	 * @version 1.105.1
 	 *
 	 * @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.104.0
+	 * @version 1.105.1
 	 *
 	 * @public
 	 * @since 1.56

package/src/sap/ui/core/format/DateFormat.js

@@ -222,6 +222,8 @@ sap.ui.define([
 	 * Get a date instance of the DateFormat, which can be used for formatting.
 	 *
 	 * @param {object} [oFormatOptions] Object which defines the format options
+	 * @param {int} [oFormatOptions.firstDayOfWeek] @since 1.105.0 specifies the first day of the week starting with <code>0</code> (which is Sunday); if not defined, the value taken from the locale is used
+	 * @param {int} [oFormatOptions.minimalDaysInFirstWeek] @since 1.105.0 minimal days at the beginning of the year which define the first calendar week; if not defined, the value taken from the locale is used
 	 * @param {string} [oFormatOptions.format] @since 1.34.0 contains pattern symbols (e.g. "yMMMd" or "Hms") which will be converted into the pattern in the used locale, which matches the wanted symbols best.
 	 *  The symbols must be in canonical order, that is: Era (G), Year (y/Y), Quarter (q/Q), Month (M/L), Week (w), Day-Of-Week (E/e/c), Day (d), Hour (h/H/k/K/j/J), Minute (m), Second (s), Timezone (z/Z/v/V/O/X/x)
 	 *  See {@link http://unicode.org/reports/tr35/tr35-dates.html#availableFormats_appendItems}
@@ -250,6 +252,8 @@ sap.ui.define([
 	 * Get a datetime instance of the DateFormat, which can be used for formatting.
 	 *
 	 * @param {object} [oFormatOptions] Object which defines the format options
+	 * @param {int} [oFormatOptions.firstDayOfWeek] @since 1.105.0 specifies the first day of the week starting with <code>0</code> (which is Sunday); if not defined, the value taken from the locale is used
+	 * @param {int} [oFormatOptions.minimalDaysInFirstWeek] @since 1.105.0 minimal days at the beginning of the year which define the first calendar week; if not defined, the value taken from the locale is used
 	 * @param {string} [oFormatOptions.format] @since 1.34.0 contains pattern symbols (e.g. "yMMMd" or "Hms") which will be converted into the pattern in the used locale, which matches the wanted symbols best.
 	 *  The symbols must be in canonical order, that is: Era (G), Year (y/Y), Quarter (q/Q), Month (M/L), Week (w), Day-Of-Week (E/e/c), Day (d), Hour (h/H/k/K/j/J), Minute (m), Second (s), Timezone (z/Z/v/V/O/X/x)
 	 *  See http://unicode.org/reports/tr35/tr35-dates.html#availableFormats_appendItems
@@ -379,6 +383,8 @@ sap.ui.define([
 	 * Get a datetimeWithTimezone instance of the DateFormat, which can be used for formatting.
 	 *
 	 * @param {object} [oFormatOptions] An object which defines the format options
+	 * @param {int} [oFormatOptions.firstDayOfWeek] @since 1.105.0 specifies the first day of the week starting with <code>0</code> (which is Sunday); if not defined, the value taken from the locale is used
+	 * @param {int} [oFormatOptions.minimalDaysInFirstWeek] @since 1.105.0 minimal days at the beginning of the year which define the first calendar week; if not defined, the value taken from the locale is used
 	 * @param {string} [oFormatOptions.format] A string containing pattern symbols (e.g. "yMMMd" or "Hms") which will be converted into a pattern for the used locale that matches the wanted symbols best.
 	 *  The symbols must be in canonical order, that is: Era (G), Year (y/Y), Quarter (q/Q), Month (M/L), Week (w), Day-Of-Week (E/e/c), Day (d), Hour (h/H/k/K/j/J), Minute (m), Second (s), Timezone (z/Z/v/V/O/X/x)
 	 *  See http://unicode.org/reports/tr35/tr35-dates.html#availableFormats_appendItems
@@ -435,6 +441,8 @@ sap.ui.define([
 	 * Get a time instance of the DateFormat, which can be used for formatting.
 	 *
 	 * @param {object} [oFormatOptions] Object which defines the format options
+	 * @param {int} [oFormatOptions.firstDayOfWeek] @since 1.105.0 specifies the first day of the week starting with <code>0</code> (which is Sunday); if not defined, the value taken from the locale is used
+	 * @param {int} [oFormatOptions.minimalDaysInFirstWeek] @since 1.105.0 minimal days at the beginning of the year which define the first calendar week; if not defined, the value taken from the locale is used
 	 * @param {string} [oFormatOptions.format] @since 1.34.0 contains pattern symbols (e.g. "yMMMd" or "Hms") which will be converted into the pattern in the used locale, which matches the wanted symbols best.
 	 *  The symbols must be in canonical order, that is: Era (G), Year (y/Y), Quarter (q/Q), Month (M/L), Week (w), Day-Of-Week (E/e/c), Day (d), Hour (h/H/k/K/j/J), Minute (m), Second (s), Timezone (z/Z/v/V/O/X/x)
 	 *  See http://unicode.org/reports/tr35/tr35-dates.html#availableFormats_appendItems
@@ -517,6 +525,11 @@ sap.ui.define([
 			oFormat.oFormatOptions.calendarType = sap.ui.getCore().getConfiguration().getCalendarType();
 		}
 
+		if (oFormat.oFormatOptions.firstDayOfWeek === undefined && oFormat.oFormatOptions.minimalDaysInFirstWeek !== undefined
+			|| oFormat.oFormatOptions.firstDayOfWeek !== undefined && oFormat.oFormatOptions.minimalDaysInFirstWeek === undefined) {
+			throw new Error("Format options firstDayOfWeek and minimalDaysInFirstWeek need both to be set, but only one was provided.");
+		}
+
 		if (!oFormat.oFormatOptions.pattern) {
 			if (oFormat.oFormatOptions.format) {
 				oFormat.oFormatOptions.pattern = oFormat.oLocaleData.getCustomDateTimePattern(oFormat.oFormatOptions.format, oFormat.oFormatOptions.calendarType);
@@ -1019,7 +1032,10 @@ sap.ui.define([
 		"Y": {
 			name: "weekYear",
 			format: function(oField, oDate, bUTC, oFormat) {
-				var oWeek = oDate.getUTCWeek();
+				var oWeek = oDate.getUTCWeek(oFormat.oLocale, {
+					firstDayOfWeek: oFormat.oFormatOptions.firstDayOfWeek,
+					minimalDaysInFirstWeek: oFormat.oFormatOptions.minimalDaysInFirstWeek
+				});
 				var iWeekYear = oWeek.year;
 				var sWeekYear = String(iWeekYear);
 				var sCalendarType = oFormat.oFormatOptions.calendarType;
@@ -1165,7 +1181,10 @@ sap.ui.define([
 		"w": {
 			name: "weekInYear",
 			format: function(oField, oDate, bUTC, oFormat) {
-				var oWeek = oDate.getUTCWeek();
+				var oWeek = oDate.getUTCWeek(oFormat.oLocale, {
+					firstDayOfWeek: oFormat.oFormatOptions.firstDayOfWeek,
+					minimalDaysInFirstWeek: oFormat.oFormatOptions.minimalDaysInFirstWeek
+				});
 				var iWeek = oWeek.week;
 				var sWeek = String(iWeek + 1);
 				if (oField.digits < 3) {
@@ -2241,7 +2260,7 @@ sap.ui.define([
 
 	// recreate javascript date object from the given oDateValues.
 	// In case of oDateValue.valid == false, null value will be returned
-	var fnCreateDate = function(oDateValue, sCalendarType, bUTC, bStrict, sTimezone) {
+	var fnCreateDate = function(oDateValue, sCalendarType, bUTC, bStrict, sTimezone, oFormatOptions, oLocale) {
 		if (!oDateValue.valid) {
 			return null;
 		}
@@ -2267,9 +2286,12 @@ sap.ui.define([
 			oDate.setUTCWeek({
 				year: oDateValue.weekYear || oDateValue.year,
 				week: oDateValue.week
+			}, oLocale, {
+				firstDayOfWeek: oFormatOptions.firstDayOfWeek,
+				minimalDaysInFirstWeek: oFormatOptions.minimalDaysInFirstWeek
 			});
 
-			//add the dayNumberOfWeek to the current day
+			// add the dayNumberOfWeek to the current day
 			if (oDateValue.dayNumberOfWeek !== undefined) {
 				oDate.setUTCDate(oDate.getUTCDate() + oDateValue.dayNumberOfWeek - 1);
 			}
@@ -2296,7 +2318,7 @@ sap.ui.define([
 			// tzDiff is in seconds for a higher precision (historical timezone might have differences in seconds)
 			// e.g. new Date(Date.UTC(1730, 0, 1))
 			// is in Berlin: Sun Jan 01 1730 00:53:28 GMT+0053 (Central European Standard Time)
-			oDate.setUTCSeconds((oDateValue.second || 0) + oDateValue.tzDiff);
+			oDate.setUTCSeconds(oDate.getUTCSeconds() + oDateValue.tzDiff);
 		}
 		return oDate;
 	};
@@ -2419,7 +2441,7 @@ sap.ui.define([
 				oDateValue.valid = false;
 			}
 
-			oJSDate = fnCreateDate(oDateValue, sCalendarType, bUTC, bStrict, sTimezone);
+			oJSDate = fnCreateDate(oDateValue, sCalendarType, bUTC, bStrict, sTimezone, this.oFormatOptions, this.oLocale);
 
 			if (oJSDate) {
 				if (this.type === mDateFormatTypes.DATETIME_WITH_TIMEZONE) {
@@ -2443,8 +2465,8 @@ sap.ui.define([
 				var oDateValue1 = mergeWithoutOverwrite(aDateValues[0], aDateValues[1]);
 				var oDateValue2 = mergeWithoutOverwrite(aDateValues[1], aDateValues[0]);
 
-				oJSDate1 = fnCreateDate(oDateValue1, sCalendarType, bUTC, bStrict, sTimezone);
-				oJSDate2 = fnCreateDate(oDateValue2, sCalendarType, bUTC, bStrict, sTimezone);
+				oJSDate1 = fnCreateDate(oDateValue1, sCalendarType, bUTC, bStrict, sTimezone, this.oFormatOptions, this.oLocale);
+				oJSDate2 = fnCreateDate(oDateValue2, sCalendarType, bUTC, bStrict, sTimezone, this.oFormatOptions, this.oLocale);
 
 				if (oJSDate1 && oJSDate2) {
 
@@ -2862,7 +2884,7 @@ sap.ui.define([
 	DateFormat.prototype._adaptDayOfWeek = function(iDayOfWeek) {
 		// day of week depends on the format locale
 		// the DateFormat's locale is independent
-		var iFirstDayOfWeek = LocaleData.getInstance(sap.ui.getCore().getConfiguration().getFormatSettings().getFormatLocale()).getFirstDayOfWeek();
+		var iFirstDayOfWeek = this.oFormatOptions.firstDayOfWeek !== undefined ? this.oFormatOptions.firstDayOfWeek : LocaleData.getInstance(this.oLocale).getFirstDayOfWeek();
 		var iDayNumberOfWeek = iDayOfWeek - (iFirstDayOfWeek - 1);
 
 		if (iDayNumberOfWeek <= 0) {

package/src/sap/ui/core/format/TimezoneUtil.js

@@ -11,7 +11,7 @@ sap.ui.define([], function() {
 	 * Static collection of utility functions to handle time zone related conversions
 	 *
 	 * @author SAP SE
-	 * @version 1.104.0
+	 * @version 1.105.1
 	 * @namespace
 	 * @alias sap.ui.core.format.TimezoneUtil
 	 * @private

package/src/sap/ui/core/hyphenation/Hyphenation.js

@@ -398,7 +398,7 @@ sap.ui.define([
 	 * @see {@link topic:6322164936f047de941ec522b95d7b70 Hyphenation for Text Controls}
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.104.0
+	 * @version 1.105.1
 	 * @hideconstructor
 	 * @public
 	 * @since 1.60

package/src/sap/ui/core/library.js

@@ -25,13 +25,13 @@ sap.ui.define([
 	 * @namespace
 	 * @alias sap.ui.core
 	 * @author SAP SE
-	 * @version 1.104.0
+	 * @version 1.105.1
 	 * @since 0.8
 	 * @public
 	 */
 	 var thisLib = sap.ui.getCore().initLibrary({
 		 name : "sap.ui.core",
-		 version: "1.104.0",
+		 version: "1.105.1",
 		 designtime: "sap/ui/core/designtime/library.designtime",
 		 types: [
 
@@ -1509,7 +1509,7 @@ sap.ui.define([
 	/**
 	 * Sort order of a column.
 	 *
-	 * @version 1.104.0
+	 * @version 1.105.1
 	 * @enum {string}
 	 * @public
 	 * @since 1.61.0
@@ -1735,6 +1735,7 @@ sap.ui.define([
 	 * @public
 	 * @experimental As of version 1.98
 	 * @since 1.98.0
+	 *
 	 */
 
 	/**
@@ -1762,7 +1763,47 @@ sap.ui.define([
 	 */
 
 	/**
+	 * Implementing this interface allows a control to be accessible via access keys.
+	 *
+	 * @name sap.ui.core.IAccessKeySupport
+	 * @interface
+	 * @public
+	 * @experimental As of version 1.104
+	 * @since 1.104
+	 */
+
+	/**
+	 * Returns a refence to DOM element to be focused during Access key navigation.
+	 * If not implemented getFocusDomRef() method is used.
+	 *
+	 * @public
+	 * @function
+	 * @experimental As of version 1.104
+	 * @since 1.104
+	 * @name sap.ui.core.IAccessKeySupport.getAccessKeysFocusTarget?
+	 */
+
+	/**
+	 * If implemented called when access keys feature is enabled and highlighting is ongoing
+	 *
+	 * @public
+	 * @function
+	 * @experimental As of version 1.104
+	 * @since 1.104
+	 * @name sap.ui.core.IAccessKeySupport.onAccKeysHighlightStart?
+	 */
+
+	/**
+	 * If implemented called when access keys feature is enabled and highlighting is over
+	 *
+	 * @public
+	 * @function
+	 * @experimental As of version 1.104
+	 * @since 1.104
+	 * @name sap.ui.core.IAccessKeySupport.onAccKeysHighlightEnd?
+	 */
 
+	/**
 	 * Marker interface for controls that can serve as a context menu.
 	 *
 	 * Implementation of this interface should implement the <code>openAsContextMenu</code> method.