@openui5/sap.ui.core 1.107.1 → 1.108.0

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

@@ -10,6 +10,8 @@ sap.ui.define([
 	'sap/ui/core/Locale',
 	'sap/ui/core/LocaleData',
 	'sap/ui/core/date/UniversalDate',
+	'sap/ui/core/date/CalendarUtils',
+	'sap/ui/core/date/CalendarWeekNumbering',
 	'sap/ui/core/format/TimezoneUtil',
 	"sap/base/util/deepEqual",
 	"sap/base/strings/formatMessage",
@@ -22,6 +24,8 @@ sap.ui.define([
 		Locale,
 		LocaleData,
 		UniversalDate,
+		CalendarUtils,
+		CalendarWeekNumbering,
 		TimezoneUtil,
 		deepEqual,
 		formatMessage,
@@ -224,6 +228,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 {sap.ui.core.date.CalendarWeekNumbering} [oFormatOptions.calendarWeekNumbering] @since 1.108.0 specifies the calendar week numbering.
+	 *   If specified, this overwrites <code>oFormatOptions.firstDayOfWeek</code> and <code>oFormatOptions.minimalDaysInFirstWeek</code>.
 	 * @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.
@@ -232,7 +238,7 @@ sap.ui.define([
 	 * @param {string} [oFormatOptions.pattern] a data pattern in LDML format. It is not verified whether the pattern represents only a date.
 	 * @param {string} [oFormatOptions.style] can be either 'short, 'medium', 'long' or 'full'. If no pattern is given, a locale dependent default date pattern of that style is used from the LocaleData class.
 	 * @param {boolean} [oFormatOptions.strictParsing] if true, by parsing it is checked if the value is a valid date
-	 * @param {boolean} [oFormatOptions.relative] if true, the date is formatted relatively to todays date if it is within the given day range, e.g. "today", "yesterday", "in 5 days"
+	 * @param {boolean} [oFormatOptions.relative] if true, the date is formatted relatively to todays date if it is within the given day range, e.g. "today", "1 day ago", "in 5 days"
 	 * @param {int[]} [oFormatOptions.relativeRange] the day range used for relative formatting. If <code>oFormatOptions.relativeScale</code> is set to default value 'day', the relativeRange is by default [-6, 6], which means only the last 6 days, today and the next 6 days are formatted relatively. Otherwise when <code>oFormatOptions.relativeScale</code> is set to 'auto', all dates are formatted relatively.
 	 * @param {string} [oFormatOptions.relativeScale="day"] if 'auto' is set, new relative time format is switched on for all Date/Time Instances. The relative scale is chosen depending on the difference between the given date and now.
 	 * @param {string} [oFormatOptions.relativeStyle="wide"] @since 1.32.10, 1.34.4 the style of the relative format. The valid values are "wide", "short", "narrow"
@@ -245,6 +251,11 @@ sap.ui.define([
 	 * @return {sap.ui.core.format.DateFormat} date instance of the DateFormat
 	 * @static
 	 * @public
+	 * @throws {TypeError} If:
+	 * <ul>
+	 *   <li>The <code>calendarWeekNumbering</code> format option has an unsupported value, or</li>
+	 *   <li>only one of the <code>firstDayOfWeek</code> and <code>minimalDaysInFirstWeek</code> parameters was provided.</li>
+	 * </ul>
 	 */
 	DateFormat.getDateInstance = function(oFormatOptions, oLocale) {
 		return this.createInstance(oFormatOptions, oLocale, this.oDateInfo);
@@ -254,6 +265,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 {sap.ui.core.date.CalendarWeekNumbering} [oFormatOptions.calendarWeekNumbering] @since 1.108.0 specifies the calendar week numbering.
+	 *   If specified, this overwrites <code>oFormatOptions.firstDayOfWeek</code> and <code>oFormatOptions.minimalDaysInFirstWeek</code>.
 	 * @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.
@@ -262,7 +275,7 @@ sap.ui.define([
 	 * @param {string} [oFormatOptions.pattern] a datetime pattern in LDML format. It is not verified whether the pattern represents a full datetime.
 	 * @param {string} [oFormatOptions.style] can be either 'short, 'medium', 'long' or 'full'. For datetime you can also define mixed styles, separated with a slash, where the first part is the date style and the second part is the time style (e.g. "medium/short"). If no pattern is given, a locale dependent default datetime pattern of that style is used from the LocaleData class.
 	 * @param {boolean} [oFormatOptions.strictParsing] if true, by parsing it is checked if the value is a valid datetime
-	 * @param {boolean} [oFormatOptions.relative] if true, the date is formatted relatively to today's date if it is within the given day range, e.g. "today", "yesterday", "in 5 days"
+	 * @param {boolean} [oFormatOptions.relative] if true, the date is formatted relatively to today's date if it is within the given day range, e.g. "today", "1 day ago", "in 5 days"
 	 * @param {int[]} [oFormatOptions.relativeRange] the day range used for relative formatting. If <code>oFormatOptions.relativeScale</code> is set to default value 'day', the relativeRange is by default [-6, 6], which means only the last 6 days, today and the next 6 days are formatted relatively. Otherwise when <code>oFormatOptions.relativeScale</code> is set to 'auto', all dates are formatted relatively.
 	 * @param {string} [oFormatOptions.relativeScale="day"] if 'auto' is set, new relative time format is switched on for all Date/Time Instances. The relative scale is chosen depending on the difference between the given date and now.
 	 * @param {string} [oFormatOptions.relativeStyle="wide"] @since 1.32.10, 1.34.4 the style of the relative format. The valid values are "wide", "short", "narrow"
@@ -275,6 +288,11 @@ sap.ui.define([
 	 * @return {sap.ui.core.format.DateFormat} datetime instance of the DateFormat
 	 * @static
 	 * @public
+	 * @throws {TypeError} If:
+	 * <ul>
+	 *   <li>The <code>calendarWeekNumbering</code> format option has an unsupported value, or</li>
+	 *   <li>only one of the <code>firstDayOfWeek</code> and <code>minimalDaysInFirstWeek</code> parameters was provided.</li>
+	 * </ul>
 	 */
 	DateFormat.getDateTimeInstance = function(oFormatOptions, oLocale) {
 		return this.createInstance(oFormatOptions, oLocale, this.oDateTimeInfo);
@@ -385,6 +403,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 {sap.ui.core.date.CalendarWeekNumbering} [oFormatOptions.calendarWeekNumbering] @since 1.108.0 specifies the calendar week numbering.
+	 *   If specified, this overwrites <code>oFormatOptions.firstDayOfWeek</code> and <code>oFormatOptions.minimalDaysInFirstWeek</code>.
 	 * @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.
@@ -399,7 +419,7 @@ sap.ui.define([
 	 *   It is ignored for formatting when an options pattern or a format are supplied.
 	 * @param {string} [oFormatOptions.style] Can be either 'short, 'medium', 'long' or 'full'. For datetime you can also define mixed styles, separated with a slash, where the first part is the date style and the second part is the time style (e.g. "medium/short"). If no pattern is given, a locale-dependent default datetime pattern of that style from the LocaleData class is used.
 	 * @param {boolean} [oFormatOptions.strictParsing] Whether to check by parsing if the value is a valid datetime
-	 * @param {boolean} [oFormatOptions.relative] Whether the date is formatted relatively to today's date if it is within the given day range, e.g. "today", "yesterday", "in 5 days"
+	 * @param {boolean} [oFormatOptions.relative] Whether the date is formatted relatively to today's date if it is within the given day range, e.g. "today", "1 day ago", "in 5 days"
 	 * @param {int[]} [oFormatOptions.relativeRange] The day range used for relative formatting. If <code>oFormatOptions.relativeScale</code> is set to the default value 'day', the <code>relativeRange<code> is by default [-6, 6], which means that only the previous 6 and the following 6 days are formatted relatively. If <code>oFormatOptions.relativeScale</code> is set to 'auto', all dates are formatted relatively.
 	 * @param {string} [oFormatOptions.relativeScale] If 'auto' is set, a new relative time format is switched on for all Date/Time instances. The default value depends on <code>showDate</code> and <code>showTime</code> options.
 	 * @param {string} [oFormatOptions.relativeStyle="wide"] The style of the relative format. The valid values are "wide", "short", "narrow"
@@ -412,6 +432,11 @@ sap.ui.define([
 	 * @static
 	 * @public
 	 * @since 1.99.0
+	 * @throws {TypeError} If:
+	 * <ul>
+	 *   <li>The <code>calendarWeekNumbering</code> format option has an unsupported value, or</li>
+	 *   <li>only one of the <code>firstDayOfWeek</code> and <code>minimalDaysInFirstWeek</code> parameters was provided.</li>
+	 * </ul>
 	 */
 	DateFormat.getDateTimeWithTimezoneInstance = function(oFormatOptions, oLocale) {
 		// do not modify the input format options
@@ -443,6 +468,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 {sap.ui.core.date.CalendarWeekNumbering} [oFormatOptions.calendarWeekNumbering] @since 1.108.0 specifies the calendar week numbering.
+	 *   If specified, this overwrites <code>oFormatOptions.firstDayOfWeek</code> and <code>oFormatOptions.minimalDaysInFirstWeek</code>.
 	 * @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.
@@ -451,7 +478,7 @@ sap.ui.define([
 	 * @param {string} [oFormatOptions.pattern] a time pattern in LDML format. It is not verified whether the pattern only represents a time.
 	 * @param {string} [oFormatOptions.style] can be either 'short, 'medium', 'long' or 'full'. If no pattern is given, a locale dependent default time pattern of that style is used from the LocaleData class.
 	 * @param {boolean} [oFormatOptions.strictParsing] if true, by parsing it is checked if the value is a valid time
-	 * @param {boolean} [oFormatOptions.relative] if true, the date is formatted relatively to todays date if it is within the given day range, e.g. "today", "yesterday", "in 5 days"
+	 * @param {boolean} [oFormatOptions.relative] if true, the date is formatted relatively to todays date if it is within the given day range, e.g. "today", "1 day ago", "in 5 days"
 	 * @param {int[]} [oFormatOptions.relativeRange] the day range used for relative formatting. If <code>oFormatOptions.relativeScale</code> is set to default value 'day', the relativeRange is by default [-6, 6], which means only the last 6 days, today and the next 6 days are formatted relatively. Otherwise when <code>oFormatOptions.relativeScale</code> is set to 'auto', all dates are formatted relatively.
 	 * @param {string} [oFormatOptions.relativeScale="day"] if 'auto' is set, new relative time format is switched on for all Date/Time Instances. The relative scale is chosen depending on the difference between the given date and now.
 	 * @param {string} [oFormatOptions.relativeStyle="wide"] @since 1.32.10, 1.34.4 the style of the relative format. The valid values are "wide", "short", "narrow"
@@ -464,6 +491,11 @@ sap.ui.define([
 	 * @return {sap.ui.core.format.DateFormat} time instance of the DateFormat
 	 * @static
 	 * @public
+	 * @throws {TypeError} If:
+	 * <ul>
+	 *   <li>The <code>calendarWeekNumbering</code> format option has an unsupported value, or</li>
+	 *   <li>only one of the <code>firstDayOfWeek</code> and <code>minimalDaysInFirstWeek</code> parameters was provided.</li>
+	 * </ul>
 	 */
 	DateFormat.getTimeInstance = function(oFormatOptions, oLocale) {
 		return this.createInstance(oFormatOptions, oLocale, this.oTimeInfo);
@@ -487,6 +519,11 @@ sap.ui.define([
 	 * @return {sap.ui.core.format.DateFormat} time instance of the DateFormat
 	 * @static
 	 * @private
+	 * @throws {TypeError} If:
+	 * <ul>
+	 *   <li>The <code>calendarWeekNumbering</code> format option has an unsupported value, or</li>
+	 *   <li>only one of the <code>firstDayOfWeek</code> and <code>minimalDaysInFirstWeek</code> parameters was provided.</li>
+	 * </ul>
 	 */
 	DateFormat.createInstance = function(oFormatOptions, oLocale, oInfo) {
 		// Create an instance of the DateFormat
@@ -529,7 +566,11 @@ sap.ui.define([
 
 		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.");
+			throw new TypeError("Format options firstDayOfWeek and minimalDaysInFirstWeek need both to be set, but only one was provided.");
+		}
+
+		if (oFormat.oFormatOptions.calendarWeekNumbering && !Object.values(CalendarWeekNumbering).includes(oFormat.oFormatOptions.calendarWeekNumbering)) {
+			throw new TypeError("Illegal format option calendarWeekNumbering: '" + oFormat.oFormatOptions.calendarWeekNumbering + "'");
 		}
 
 		if (!oFormat.oFormatOptions.pattern) {
@@ -650,7 +691,9 @@ sap.ui.define([
 		this.aErasNarrow = this.oLocaleData.getEras("narrow", sCalendarType);
 		this.aErasAbbrev = this.oLocaleData.getEras("abbreviated", sCalendarType);
 		this.aErasWide = this.oLocaleData.getEras("wide", sCalendarType);
-		this.aDayPeriods = this.oLocaleData.getDayPeriods("abbreviated", sCalendarType);
+		this.aDayPeriodsAbbrev = this.oLocaleData.getDayPeriods("abbreviated", sCalendarType);
+		this.aDayPeriodsNarrow = this.oLocaleData.getDayPeriods("narrow", sCalendarType);
+		this.aDayPeriodsWide = this.oLocaleData.getDayPeriods("wide", sCalendarType);
 		this.aFormatArray = this.parseCldrDatePattern(this.oFormatOptions.pattern);
 		this.sAllowedCharacters = this.getAllowedCharacters(this.aFormatArray);
 	};
@@ -870,7 +913,8 @@ sap.ui.define([
 	};
 
 	/**
-	 * Pattern elements
+	 * Provides functionality to format and parse a given pattern symbol.
+	 * @see https://unicode.org/reports/tr35/tr35-dates.html#table-date-field-symbol-table
 	 */
 	DateFormat.prototype.oSymbols = {
 		"": {
@@ -1034,10 +1078,7 @@ sap.ui.define([
 		"Y": {
 			name: "weekYear",
 			format: function(oField, oDate, bUTC, oFormat) {
-				var oWeek = oDate.getUTCWeek(oFormat.oLocale, {
-					firstDayOfWeek: oFormat.oFormatOptions.firstDayOfWeek,
-					minimalDaysInFirstWeek: oFormat.oFormatOptions.minimalDaysInFirstWeek
-				});
+				var oWeek = oDate.getUTCWeek(oFormat.oLocale, getCalendarWeekParameter(oFormat.oFormatOptions));
 				var iWeekYear = oWeek.year;
 				var sWeekYear = String(iWeekYear);
 				var sCalendarType = oFormat.oFormatOptions.calendarType;
@@ -1183,10 +1224,7 @@ sap.ui.define([
 		"w": {
 			name: "weekInYear",
 			format: function(oField, oDate, bUTC, oFormat) {
-				var oWeek = oDate.getUTCWeek(oFormat.oLocale, {
-					firstDayOfWeek: oFormat.oFormatOptions.firstDayOfWeek,
-					minimalDaysInFirstWeek: oFormat.oFormatOptions.minimalDaysInFirstWeek
-				});
+				var oWeek = oDate.getUTCWeek(oFormat.oLocale, getCalendarWeekParameter(oFormat.oFormatOptions));
 				var iWeek = oWeek.week;
 				var sWeek = String(iWeek + 1);
 				if (oField.digits < 3) {
@@ -1455,48 +1493,114 @@ sap.ui.define([
 		},
 		"a": {
 			name: "amPmMarker",
-			format: function(oField, oDate, bUTC, oFormat) {
+			/**
+			 * Formats the day period.
+			 *
+			 * @param {Object<string, any>} oField
+			 *   The date pattern field as parsed by {@link DateFormat#parseCldrDatePattern}
+			 * @param {number} oField.digits
+			 *   The number of repetitions of the pattern symbol, e.g. <code>3</code> for "aaa"
+			 * @param {string} oField.symbol
+			 *   The pattern symbol "a"
+			 * @param {string} oField.type
+			 *   The symbol name "amPmMarker"
+			 * @param {sap.ui.core.date.UniversalDate} oDate
+			 *   The date to format
+			 * @param {boolean} [bUTC]
+			 *   Whether the UTC option is set; not used
+			 * @param {sap.ui.core.format.DateFormat} oFormat
+			 *   The <code>DateFormat</code> instance
+			 * @returns {string}
+			 *   The formatted day period, e.g. "AM" for symbol "a"
+			 */
+			format : function (oField, oDate, bUTC, oFormat) {
 				var iDayPeriod = oDate.getUTCDayPeriod();
 
-				return oFormat.aDayPeriods[iDayPeriod];
+				if (oField.digits <= 3) {
+					return oFormat.aDayPeriodsAbbrev[iDayPeriod];
+				} else if (oField.digits === 4) {
+					return oFormat.aDayPeriodsWide[iDayPeriod];
+				} else {
+					return oFormat.aDayPeriodsNarrow[iDayPeriod];
+				}
 			},
-			parse: function(sValue, oPart, oFormat, oConfig) {
-				var bPM;
-				var iLength;
-				var sAM = oFormat.aDayPeriods[0],
-					sPM = oFormat.aDayPeriods[1];
-
-				// check whether the value is one of the ASCII variants for AM/PM
-				// for example: "am", "a.m.", "am.", "a. m." (and their case variants)
-				// if true, remove the '.', the spaces and compare with the defined am/pm case
-				// insensitive
-				var rAMPM = /[aApP](?:\.)?[\x20\xA0]?[mM](?:\.)?/;
-				var aMatch = sValue.match(rAMPM);
-				var bVariant = (aMatch && aMatch.index === 0);
-
-				if (bVariant) {
-					sValue = aMatch[0];
-
-					// Remove normal and non-breaking spaces
-					sAM = sAM.replace(/[\x20\xA0]/g, "");
-					sPM = sPM.replace(/[\x20\xA0]/g, "");
-					sValue = sValue.replace(/[\x20\xA0]/g, "");
-
-					// Remove dots and make it lowercase
-					sAM = sAM.replace(/\./g, "").toLowerCase();
-					sPM = sPM.replace(/\./g, "").toLowerCase();
-					sValue = sValue.replace(/\./g, "").toLowerCase();
-				}
-				if (sValue.indexOf(sAM) === 0) {
-					bPM = false;
-					iLength = (bVariant ? aMatch[0].length : sAM.length);
-				} else if (sValue.indexOf(sPM) === 0) {
-					bPM = true;
-					iLength = (bVariant ? aMatch[0].length : sPM.length);
+
+			/**
+			 * Parses the day period from a given input string.
+			 *
+			 * @param {string} sValue
+			 *   The given input, e.g. "am 13:37"
+			 * @param {Object<string, any>} oPart
+			 *   The date pattern field as parsed by {@link DateFormat#parseCldrDatePattern}
+			 * @param {number} oPart.digits
+			 *   The number of repetitions of the pattern symbol, e.g. <code>3</code> for "aaa"
+			 * @param {string} oPart.symbol
+			 *   The pattern symbol "a"
+			 * @param {string} oPart.type
+			 *   The symbol name "amPmMarker"
+			 * @param {sap.ui.core.format.DateFormat} oFormat
+			 *   The <code>DateFormat</code> instance
+			 * @param {Object<string, any>} [oConfig]
+			 *   The configuration object for parsing the value
+			 * @param {object[]} [oConfig.formatArray]
+			 *   The complete format array as parsed by {@link DateFormat#parseCldrDatePattern}
+			 * @param {object} [oConfig.dateValue]
+			 *   The already parsed date fields
+			 * @param {number} [oConfig.index]
+			 *   The index in the format array
+			 * @param {boolean} [oConfig.strict]
+			 *   Whether to use the strict option
+			 * @param {string} [sTimezone]
+			 *   The IANA timezone ID
+			 * @returns {{length : number, pm : boolean}|{}}
+			 *   An object with the <code>length</code> of the match and the parsed <code>pm</code>
+			 *   value; or an object with property valid <code>false</code> if it could not be
+			 *   parsed correctly
+			 */
+			parse : function (sValue, oPart, oFormat, oConfig, sTimezone) {
+				// process longer patterns first to find the longest match
+				// wide > abbreviated > narrow
+				var rAMPM, bAMPMAlternativeCase, oEntry, i, aMatch, normalize, aVariants,
+					aDayPeriodsVariants = [oFormat.aDayPeriodsWide, oFormat.aDayPeriodsAbbrev,
+						oFormat.aDayPeriodsNarrow];
+
+				// Support ASCII alternative writings for AM/PM (when the locale has am/pm in its
+				// patterns), e.g. "am", "a.m.", "am.", "a. m." (and their case alternatives)
+				// see: https://unicode.org/reports/tr35/tr35-dates.html#Parsing_Dates_Times
+				rAMPM = /[aApP](?:\.)?[\x20\xA0]?[mM](?:\.)?/;
+				aMatch = sValue.match(rAMPM);
+				bAMPMAlternativeCase = aMatch && aMatch.index === 0;
+				function normalize (sValue) {
+					// Remove normal and non-breaking spaces and remove dots
+					return sValue.replace(/[\x20\xA0]/g, "").replace(/\./g, "");
+				}
+				if (bAMPMAlternativeCase) {
+					sValue = normalize(sValue);
+				}
+
+				for (i = 0; i < aDayPeriodsVariants.length; i += 1) {
+					aVariants = aDayPeriodsVariants[i];
+
+					if (bAMPMAlternativeCase) {
+						// check normalized match for alternative case of am/pm
+						aVariants = aVariants.map(normalize);
+					}
+					// check exact and case-insensitive match
+					oEntry = oParseHelper.findEntry(sValue, aVariants,
+						oFormat.oLocaleData.sCLDRLocaleId);
+					if (oEntry.index !== -1) {
+						return {
+							pm : oEntry.index === 1,
+							// am/pm alternative may include an additional dot, e.g. "am."
+							// therefore the length for the am/pm alternative is the length of the
+							// match
+							length : bAMPMAlternativeCase ? aMatch[0].length : oEntry.length
+						};
+					}
 				}
+
 				return {
-					pm: bPM,
-					length: iLength
+					valid: false
 				};
 			}
 		},
@@ -2248,6 +2352,28 @@ sap.ui.define([
 		return aDateValues;
 	};
 
+	/**
+	 * Retrieves the parameter for the calendar week configuration from the DateFormat's format
+	 * options
+	 *
+	 * @param {{firstDayOfWeek: int, minimalDaysInFirstWeek: int, calendarWeekNumbering: sap.ui.core.date.CalendarWeekNumbering}} oFormatOptions
+	 *   The format options with which the DateFormat instance was created
+	 * @returns {sap.ui.core.date.CalendarWeekNumbering|{firstDayOfWeek: int, minimalDaysInFirstWeek: int}|undefined}
+	 *   The parameter for the calendar week configuration
+	 */
+	function getCalendarWeekParameter (oFormatOptions) {
+		if (oFormatOptions.calendarWeekNumbering) {
+			return oFormatOptions.calendarWeekNumbering;
+		// either both are provided or none (checked in DateFormat.createInstance)
+		} else if (oFormatOptions.firstDayOfWeek !== undefined && oFormatOptions.minimalDaysInFirstWeek !== undefined) {
+			return {
+				firstDayOfWeek: oFormatOptions.firstDayOfWeek,
+				minimalDaysInFirstWeek: oFormatOptions.minimalDaysInFirstWeek
+			};
+		}
+		return undefined;
+	}
+
 	/**
 	 * Converts a given date to the given timezone if bUTC is false
 	 *
@@ -2293,10 +2419,7 @@ sap.ui.define([
 			oDate.setUTCWeek({
 				year: oDateValue.weekYear || oDateValue.year,
 				week: oDateValue.week
-			}, oLocale, {
-				firstDayOfWeek: oFormatOptions.firstDayOfWeek,
-				minimalDaysInFirstWeek: oFormatOptions.minimalDaysInFirstWeek
-			});
+			}, oLocale, getCalendarWeekParameter(oFormatOptions));
 
 			// add the dayNumberOfWeek to the current day
 			if (oDateValue.dayNumberOfWeek !== undefined) {
@@ -2891,7 +3014,14 @@ sap.ui.define([
 	DateFormat.prototype._adaptDayOfWeek = function(iDayOfWeek) {
 		// day of week depends on the format locale
 		// the DateFormat's locale is independent
-		var iFirstDayOfWeek = this.oFormatOptions.firstDayOfWeek !== undefined ? this.oFormatOptions.firstDayOfWeek : LocaleData.getInstance(this.oLocale).getFirstDayOfWeek();
+		var vCalendarWeekParameter = getCalendarWeekParameter(this.oFormatOptions),
+			iFirstDayOfWeek;
+		if (typeof vCalendarWeekParameter === "object") {
+			iFirstDayOfWeek = vCalendarWeekParameter.firstDayOfWeek;
+		} else {
+			iFirstDayOfWeek = CalendarUtils.getWeekConfigurationValues(vCalendarWeekParameter, this.oLocale).firstDayOfWeek;
+		}
+
 		var iDayNumberOfWeek = iDayOfWeek - (iFirstDayOfWeek - 1);
 
 		if (iDayNumberOfWeek <= 0) {

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

@@ -2782,25 +2782,63 @@ sap.ui.define([
 	 * Identify the longest match between a sub string of <code>sValue</code>
 	 * and one of the values of the <code>mCollection</code> map.
 	 *
-	 * @param {string} sValue the string value which is checked for all currency codes/symbols during a parse call
-	 * @param {object} mCollection a collection of currency codes or symbols
-	 *
-	 * @return {object} returns object containing matched symbol/ code
+	 * @param {string} sValue
+	 *   The string value which is checked for all currency codes/symbols
+	 * @param {Object<string, string>} mCollection
+	 *   An object mapping a currency code to a either a currency symbol or the currency code itself
+	 * @param {boolean} bCaseInsensitive Whether case insensitive matches are allowed
+	 * @return {{code: string, recognizedCurrency: string, symbol: string}}
+	 *   An object with the code, the recognized currency and the symbol found in the given value;
+	 *   an empty object in case of either conflicting case insensitive matches, or no match
 	 */
-	function findLongestMatch(sValue, mCollection) {
-		var sSymbol = "", sCode, sCurSymbol;
-
-		for (var sCurCode in mCollection) {
+	function findLongestMatch(sValue, mCollection, bCaseInsensitive) {
+		var sCode, sCurCode, sCurSymbol, sCurSymbolToUpperCase, iIndex, sLanguageTag,
+			sRecognizedCurrency, sValueSubStr,
+			bDuplicate = false,
+			bExactMatch = false,
+			sSymbol = "";
+
+		for (sCurCode in mCollection) {
 			sCurSymbol = mCollection[sCurCode];
-			if (sValue.indexOf(sCurSymbol) >= 0 && sSymbol.length < sCurSymbol.length) {
-				sSymbol = sCurSymbol;
+			if (!sCurSymbol) {
+				continue;
+			}
+			if (sValue.indexOf(sCurSymbol) >= 0 && sSymbol.length <= sCurSymbol.length) {
 				sCode = sCurCode;
+				bDuplicate = false;
+				bExactMatch = true;
+				sSymbol = sCurSymbol;
+				sRecognizedCurrency = sCurSymbol;
+			} else if (bCaseInsensitive) {
+				sLanguageTag = Configuration.getLanguageTag();
+				sCurSymbolToUpperCase = sCurSymbol.toLocaleUpperCase(sLanguageTag);
+				iIndex = sValue.toLocaleUpperCase(sLanguageTag).indexOf(sCurSymbolToUpperCase);
+				if (iIndex >= 0) {
+					if (sSymbol.length === sCurSymbol.length && !bExactMatch) {
+						bDuplicate = true;
+					} else if (sSymbol.length < sCurSymbol.length) {
+						sValueSubStr = sValue.substring(iIndex, iIndex + sCurSymbol.length);
+						if (sValueSubStr.toLocaleUpperCase(sLanguageTag)
+								=== sCurSymbolToUpperCase) {
+							sCode = sCurCode;
+							bDuplicate = false;
+							bExactMatch = false;
+							sSymbol = sCurSymbol;
+							sRecognizedCurrency = sValueSubStr;
+						}
+					}
+				}
 			}
 		}
 
+		if (bDuplicate || !sCode) {
+			return {};
+		}
+
 		return {
-			symbol: sSymbol,
-			code: sCode
+			code : sCode,
+			recognizedCurrency : sRecognizedCurrency,
+			symbol : sSymbol
 		};
 	}
 
@@ -2823,7 +2861,8 @@ sap.ui.define([
 	 * @returns {object|undefined} returns object containing numberValue and currencyCode or undefined
 	 */
 	function parseNumberAndCurrency(oConfig) {
-		var sValue = oConfig.value;
+		var aIsoMatches,
+			sValue = oConfig.value;
 
 		// Search for known symbols (longest match)
 		// no distinction between default and custom currencies
@@ -2833,26 +2872,28 @@ sap.ui.define([
 		if (!oMatch.code) {
 			// before falling back to the default regex for ISO codes we check the
 			// codes for custom currencies (if defined)
-			oMatch = findLongestMatch(sValue, oConfig.customCurrencyCodes);
+			oMatch = findLongestMatch(sValue, oConfig.customCurrencyCodes, true);
 
 			if (!oMatch.code && !oConfig.customCurrenciesAvailable) {
 				// Match 3-letter iso code
-				var aIsoMatches = sValue.match(/(^[A-Z]{3}|[A-Z]{3}$)/);
-				oMatch.code = aIsoMatches && aIsoMatches[0];
+				aIsoMatches = sValue.match(/(^[A-Z]{3}|[A-Z]{3}$)/i);
+				oMatch.code = aIsoMatches
+					&& aIsoMatches[0].toLocaleUpperCase(Configuration.getLanguageTag());
+				oMatch.recognizedCurrency = aIsoMatches && aIsoMatches[0];
 			}
 		}
 
 		// Remove symbol/code from value
 		if (oMatch.code) {
-			var iLastCodeIndex = oMatch.code.length - 1;
-			var sLastCodeChar = oMatch.code.charAt(iLastCodeIndex);
+			var iLastCodeIndex = oMatch.recognizedCurrency.length - 1;
+			var sLastCodeChar = oMatch.recognizedCurrency.charAt(iLastCodeIndex);
 			var iDelimiterPos;
 			var rValidDelimiters = /[\-\s]+/;
 
 			// Check whether last character of matched code is a number
 			if (/\d$/.test(sLastCodeChar)) {
 				// Check whether parse string starts with the matched code
-				if (sValue.startsWith(oMatch.code)) {
+				if (sValue.startsWith(oMatch.recognizedCurrency)) {
 					iDelimiterPos = iLastCodeIndex + 1;
 					// \s matching any whitespace character including
 					// non-breaking ws and invisible non-breaking ws
@@ -2861,16 +2902,16 @@ sap.ui.define([
 					}
 				}
 			// Check whether first character of matched code is a number
-			} else if (/^\d/.test(oMatch.code)) {
+			} else if (/^\d/.test(oMatch.recognizedCurrency)) {
 				// Check whether parse string ends with the matched code
-				if (sValue.endsWith(oMatch.code)) {
-					iDelimiterPos = sValue.indexOf(oMatch.code) - 1;
+				if (sValue.endsWith(oMatch.recognizedCurrency)) {
+					iDelimiterPos = sValue.indexOf(oMatch.recognizedCurrency) - 1;
 					if (!rValidDelimiters.test(sValue.charAt(iDelimiterPos))) {
 						return undefined;
 					}
 				}
 			}
-			sValue = sValue.replace(oMatch.symbol || oMatch.code, "");
+			sValue = sValue.replace(oMatch.recognizedCurrency, "");
 		}
 
 		// Set currency code to undefined, as the defined custom currencies

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.107.1
+	 * @version 1.108.0
 	 * @namespace
 	 * @alias sap.ui.core.format.TimezoneUtil
 	 * @private
@@ -129,7 +129,9 @@ sap.ui.define([], function() {
 	 * var oDate = new Date("2021-10-13T15:22:33Z"); // UTC
 	 * // time zone difference UTC-4 (DST)
 	 * TimezoneUtil.convertToTimezone(oDate, "America/New_York");
+	 * result is:
 	 * // 2021-10-13 11:22:33 in America/New_York
+	 * // same as new Date("2021-10-13T11:22:33Z"); // UTC
 	 *
 	 * @param {Date} oDate The date which should be converted.
 	 * @param {string} sTargetTimezone The target IANA timezone ID, e.g <code>"Europe/Berlin"</code>

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

@@ -400,7 +400,7 @@ sap.ui.define([
 	 * @see {@link topic:6322164936f047de941ec522b95d7b70 Hyphenation for Text Controls}
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.107.1
+	 * @version 1.108.0
 	 * @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.107.1
+	 * @version 1.108.0
 	 * @since 0.8
 	 * @public
 	 */
 	 var thisLib = sap.ui.getCore().initLibrary({
 		 name : "sap.ui.core",
-		 version: "1.107.1",
+		 version: "1.108.0",
 		 designtime: "sap/ui/core/designtime/library.designtime",
 		 types: [
 
@@ -813,7 +813,13 @@ sap.ui.define([
 		 * Type: Large size
 		 * @public
 		 */
-		Large : "Large"
+		Large : "Large",
+
+		/**
+		 * Type: Medium size, specifically if the BusyIndicator is displayed over a page section
+		 * @public
+		 */
+		Section : "Section"
 	};
 
 	// Note: the imported module sap/ui/core/CalendarType already defines the global sap.ui.core.CalendarType,
@@ -821,13 +827,16 @@ sap.ui.define([
 	// thisLib.CalendarType = CalendarType;
 
 	/**
-	 * @classdesc A string type that represents CSS color values.
+	 * @classdesc A string type that represents CSS color values (CSS Color Level 3).
 	 *
-	 * Allowed values are CSS hex colors like "#666666" or "#fff", RGB/HSL values like "rgb(0,0,0)"
-	 * or "hsla(50%,10%,30%,0.5)" as well as CSS color names like "green" and "darkblue" and special
-	 * values like "inherit" and "transparent".
-	 *
-	 * The empty string is also allowed and has the same effect as setting no color.
+	 * <b>Allowed values are:</b>
+	 * <ul>
+	 *   <li>Hex colors like <code>#666666</code> or <code>#fff</code>,</li>
+	 *   <li>HSL/RGB values with or without transparency, like <code>hsla(90,10%,30%,0.5)</code> or <code>rgb(0,0,0)</code>,</li>
+	 *   <li>CSS color names like <code>darkblue</code>, or special values like <code>inherit</code> and <code>transparent</code>,</li>
+	 *   <li>an empty string, which has the same effect as setting no color.</li>
+	 * </ul>
+	 * For more information about the CSS Level 3 color specification, see {@link https://www.w3.org/TR/css-color-3/#css-system}.
 	 *
 	 * @final
 	 * @namespace
@@ -1482,7 +1491,7 @@ sap.ui.define([
 	/**
 	 * Sort order of a column.
 	 *
-	 * @version 1.107.1
+	 * @version 1.108.0
 	 * @enum {string}
 	 * @public
 	 * @since 1.61.0