@openui5/sap.ui.core 1.120.6 → 1.121.0

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

@@ -6,17 +6,18 @@
 
 // Provides class sap.ui.core.format.NumberFormat
 sap.ui.define([
+	"sap/base/i18n/Formatting",
+	"sap/base/i18n/Localization",
 	'sap/ui/base/Object',
 	'sap/ui/core/Locale',
 	'sap/ui/core/LocaleData',
 	'sap/ui/core/Supportability',
+	'sap/ui/core/format/FormatUtils',
 	'sap/base/Log',
 	'sap/base/assert',
-	'sap/base/util/extend',
-	'sap/ui/core/Configuration'
-
+	'sap/base/util/extend'
 ],
-	function(BaseObject, Locale, LocaleData, Supportability, Log, assert, extend, Configuration) {
+	function(Formatting, Localization, BaseObject, Locale, LocaleData, Supportability, FormatUtils, Log, assert, extend) {
 	"use strict";
 
 
@@ -47,17 +48,22 @@ sap.ui.define([
 		}
 	});
 
-	var rAllWhiteSpaces = /\s/g,
-		rDigit = /\d/,
-		// Regex for checking if a number has leading zeros
-		rLeadingZeros = /^(-?)0+(\d)/,
-		// Not matching Sc (currency symbol) and Z (separator) characters
-		// https://www.unicode.org/reports/tr44/#General_Category_Values
-		rNotSAndNotZ = /[^\$\xA2-\xA5\u058F\u060B\u09F2\u09F3\u09FB\u0AF1\u0BF9\u0E3F\u17DB\u20A0-\u20BD\uA838\uFDFC\uFE69\uFF04\uFFE0\uFFE1\uFFE5\uFFE6\u0020\xA0\u1680\u2000-\u200A\u2028\u2029\u202F\u205F\u3000]/,
-		// Regex for matching the number placeholder in pattern
-		rNumPlaceHolder = /0+(\.0+)?/,
-		// Regex for checking that the given string only consists of '0' characters
-		rOnlyZeros = /^0+$/;
+	const rAllWhiteSpaces = /\s/g;
+	const rDigit = /\d/;
+	// Regex for checking if a number has leading zeros
+	const rLeadingZeros = /^(-?)0+(\d)/;
+	// Not matching Sc (currency symbol) and Z (separator) characters
+	// https://www.unicode.org/reports/tr44/#General_Category_Values
+	const rNotSAndNotZ = /[^\$\xA2-\xA5\u058F\u060B\u09F2\u09F3\u09FB\u0AF1\u0BF9\u0E3F\u17DB\u20A0-\u20BD\uA838\uFDFC\uFE69\uFF04\uFFE0\uFFE1\uFFE5\uFFE6\u0020\xA0\u1680\u2000-\u200A\u2028\u2029\u202F\u205F\u3000]/;
+	// Regex for matching the number placeholder in pattern
+	const rNumPlaceHolder = /0+(\.0+)?/;
+	// Regex for checking that the given string only consists of '0' characters
+	const rOnlyZeros = /^0+$/;
+	// A regular expresssion that can be used to remove a leading "-" from a number representing zero,
+	// e.g. "-0", or "-0.00"; $1 contains the number without the leading "-"
+	const rRemoveMinusFromZero = /^-(0(?:.0+)?)$/;
+	// A regular expression that can be used to remove trailing zeros from a number
+	const rTrailingZeros = /0+$/;
 
 	/*
 	 * Is used to validate existing grouping separators.
@@ -140,25 +146,154 @@ sap.ui.define([
 		HALF_AWAY_FROM_ZERO: "HALF_AWAY_FROM_ZERO"
 	};
 
-	var mRoundingFunction = {};
-	mRoundingFunction[mRoundingMode.FLOOR] = Math.floor;
-	mRoundingFunction[mRoundingMode.CEILING] = Math.ceil;
-	mRoundingFunction[mRoundingMode.TOWARDS_ZERO] = function(nValue) {
-		return nValue > 0 ? Math.floor(nValue) : Math.ceil(nValue);
-	};
-	mRoundingFunction[mRoundingMode.AWAY_FROM_ZERO] = function(nValue) {
-		return nValue > 0 ? Math.ceil(nValue) : Math.floor(nValue);
-	};
-	mRoundingFunction[mRoundingMode.HALF_TOWARDS_ZERO] = function(nValue) {
-		return nValue > 0 ? Math.ceil(nValue - 0.5) : Math.floor(nValue + 0.5);
-	};
-	mRoundingFunction[mRoundingMode.HALF_AWAY_FROM_ZERO] = function(nValue) {
-		return nValue > 0 ? Math.floor(nValue + 0.5) : Math.ceil(nValue - 0.5);
+	/**
+	 * Adds the summand given as a number to an decimal given as a string.
+	 *
+	 * @param {string} sDecimal A positive or negative decimal number as string
+	 * @param {int} iSummand An integer between -9 and 9 to be added to the given decimal number
+	 * @returns {string} The sum of the two numbers as a string
+	 *
+	 * @private
+	 */
+	NumberFormat.add = function (sDecimal, iSummand) {
+		const aParts = sDecimal.split(".");
+		let sInteger = aParts[0];
+		const sFractionPart = aParts[1];
+		const bNegative = sInteger[0] === "-";
+		if (bNegative) {
+			sInteger = sInteger.slice(1);
+			iSummand = -iSummand;
+		}
+		const aDigits = sInteger.split("").map(Number);
+		const iLastIndex = aDigits.length - 1;
+		aDigits[iLastIndex] += iSummand;
+		for (let i = iLastIndex; i >= 0; i -= 1) {
+			if (aDigits[i] >= 10) {
+				aDigits[i] = aDigits[i] % 10;
+				if (i === 0) {
+					aDigits.unshift(1);
+					break;
+				}
+				aDigits[i - 1] += 1;
+			} else if (aDigits[i] < 0 && i > 0) {
+				aDigits[i] = 10 + aDigits[i];
+				aDigits[i - 1] -= 1;
+				if (i === 1 && aDigits[0] === 0) {
+					aDigits.shift();
+					break;
+				}
+			} else {
+				break;
+			}
+		}
+		if (bNegative) {
+			aDigits[0] = -aDigits[0];
+		}
+		let sResult = aDigits.join("");
+		if (!sFractionPart) {
+			return sResult;
+		}
+
+		// If sResult is 0, the sign may be lost and has to be restored, e.g. "-5.123" + 5 => -5 + 5 = 0 => "-0.123"
+		sResult = sResult === "0" && bNegative ? "-0" : sResult;
+		const sResultSign = sResult[0] === "-" ? "-" : "";
+		// If both signs are equal, the fraction part can simply be appended
+		if (bNegative === !!sResultSign) {
+			return sResult + "." + sFractionPart;
+		}
+
+		// If the signs are different, aDigits contains only one digit which is different from zero; to compute the
+		// result, the result sign has to be kept, the integer part is the absolute sResult reduced by one, and the
+		// fractional part is (1 - fractional part), e.g. "2.123" - 5 => 2 - 5 = -3 => sign = "-", integer part is
+		// |-3| - 1 = 2 and fractional part is 1 - 0.123 = 0.877 without the leading "0." => "-2.877"
+		const aFractionDigits = sFractionPart.split("").map(Number);
+		for (let i = aFractionDigits.length - 1; i >= 0; i -= 1) {
+			aFractionDigits[i] = 10 - aFractionDigits[i];
+			if (i > 0) {
+				aFractionDigits[i - 1] += 1;
+			}
+		}
+		return sResultSign + (Math.abs(aDigits[0]) - 1) + "." + aFractionDigits.join("");
 	};
-	mRoundingFunction[mRoundingMode.HALF_FLOOR] = function(nValue) {
-		return Math.ceil(nValue - 0.5);
+
+	/**
+	 * Rounds the given number up to the smallest integer greater than or equal to the given number.
+	 *
+	 * @param {number|string} vNumber
+	 *   The number to be rounded up; it has at least one digit in front of the decimal point in case of type "string"
+	 * @returns {number|string}
+	 *   The smallest integer greater than or equal to the given number; the returned type is the same as the type of
+	 *   the given number
+	 */
+	function ceil(vNumber) {
+		if (typeof vNumber === "number") {
+			return Math.ceil(vNumber);
+		}
+
+		const [sIntegerPart, sFractionPart = "0"] = vNumber.split(".");
+		return rOnlyZeros.test(sFractionPart) || sIntegerPart[0] === "-"
+			? sIntegerPart
+			: NumberFormat.add(sIntegerPart, 1);
+	}
+
+	/**
+	 * Rounds the given number down to the largest integer less than or equal to the given number.
+	 *
+	 * @param {number|string} vNumber
+	 *   The number to be rounded down; it has at least one digit in front of the decimal point in case of type "string"
+	 * @returns {number|string}
+	 *   The largest integer less than or equal to the given number; the returned type is the same as the type of the
+	 *   given number
+	 */
+	function floor(vNumber) {
+		if (typeof vNumber === "number") {
+			return Math.floor(vNumber);
+		}
+
+		const [sIntegerPart, sFractionPart = "0"] = vNumber.split(".");
+		return rOnlyZeros.test(sFractionPart) || sIntegerPart[0] !== "-"
+			? sIntegerPart
+			: NumberFormat.add(sIntegerPart, -1);
+	}
+
+	/**
+	 * Adds 0.5 to or subtracts 0.5 from the given number.
+	 *
+	 * @param {number|string} vNumber
+	 *   The number to be increased or decreased by 0.5
+	 * @param {boolean} bIncrease
+	 *   Whether to increase the number by 0.5; otherwise the number is decreased by 0.5
+	 * @returns {number|string}
+	 *   The number increased or decreased by 0.5; the returned type is the same as the type of the given number
+	 */
+	function increaseOrDecreaseByHalf(vNumber, bIncrease) {
+		if (typeof vNumber === "number") {
+			return bIncrease ? vNumber + 0.5 : vNumber - 0.5;
+		}
+
+		vNumber = NumberFormat._shiftDecimalPoint(vNumber, 1);
+		vNumber = NumberFormat.add(vNumber, bIncrease ? 5 : -5);
+		return NumberFormat._shiftDecimalPoint(vNumber, -1);
+	}
+
+	const mRoundingFunction = {
+		[mRoundingMode.FLOOR]: floor,
+		[mRoundingMode.CEILING]: ceil,
+		[mRoundingMode.TOWARDS_ZERO]: (vNumber) => (vNumber > 0 ? floor(vNumber) : ceil(vNumber)),
+		[mRoundingMode.AWAY_FROM_ZERO]: (vNumber) => (vNumber > 0 ? ceil(vNumber) : floor(vNumber)),
+		[mRoundingMode.HALF_TOWARDS_ZERO]: (vNumber) => {
+			const bPositive = vNumber > 0;
+			vNumber = increaseOrDecreaseByHalf(vNumber, !bPositive);
+			return bPositive ? ceil(vNumber) : floor(vNumber);
+		},
+		[mRoundingMode.HALF_AWAY_FROM_ZERO]: (vNumber) => {
+			const bPositive = vNumber > 0;
+			vNumber = increaseOrDecreaseByHalf(vNumber, bPositive);
+			return bPositive ? floor(vNumber) : ceil(vNumber);
+		},
+		[mRoundingMode.HALF_FLOOR]: (vNumber) => ceil(increaseOrDecreaseByHalf(vNumber, false)),
+		[mRoundingMode.HALF_CEILING]: (vNumber) => floor(increaseOrDecreaseByHalf(vNumber, true))
 	};
-	mRoundingFunction[mRoundingMode.HALF_CEILING] = Math.round;
 
 	NumberFormat.RoundingMode = mRoundingMode;
 
@@ -322,9 +457,6 @@ sap.ui.define([
 	/**
 	 * Get a float instance of the NumberFormat, which can be used for formatting.
 	 *
-	 * If no locale is given, the currently configured
-	 * {@link sap.ui.core.Configuration.FormatSettings#getFormatLocale formatLocale} will be used.
-	 *
 	 * <p>
 	 * This instance has HALF_AWAY_FROM_ZERO set as default rounding mode.
 	 * Please set the roundingMode property in oFormatOptions to change the
@@ -381,12 +513,14 @@ sap.ui.define([
 	 *   <code>maxFractionDigits</code> format option allows.
 	 *   If decimals are not preserved, the formatted number is rounded to <code>maxFractionDigits</code>.
 	 * @param {sap.ui.core.format.NumberFormat.RoundingMode} [oFormatOptions.roundingMode=HALF_AWAY_FROM_ZERO]
-	 *   specifies the rounding behavior for discarding the digits after the maximum fraction digits
-	 *   defined by maxFractionDigits. Rounding will only be applied if the passed value is of type <code>number</code>.
+	 *   Specifies the rounding behavior for discarding the digits after the maximum fraction digits
+	 *   defined by <code>maxFractionDigits</code>.
 	 *   This can be assigned
 	 *   <ul>
 	 *     <li>by value in {@link sap.ui.core.format.NumberFormat.RoundingMode RoundingMode},</li>
-	 *     <li>via a function that is used for rounding the number and takes two parameters: the number itself, and the number of decimal digits that should be reserved.</li>
+	 *     <li>via a function that is used for rounding the number and takes two parameters: the number itself, and the
+	 *         number of decimal digits that should be reserved. <b>Using a function is deprecated since 1.121.0</b>;
+	 *         string based numbers are not rounded via this custom function.</li>
 	 *   </ul>
 	 * @param {int} [oFormatOptions.shortDecimals] defines the number of decimal in the shortened format string. If this isn't specified, the 'decimals' options is used
 	 * @param {int} [oFormatOptions.shortLimit] only use short number formatting for values above this limit
@@ -400,7 +534,9 @@ sap.ui.define([
 	 *   numbers are formatted into compact forms. When this option is set, the default value of the
 	 *   'precision' option is set to 2. This can be changed by setting either min/maxFractionDigits,
 	 *   decimals, shortDecimals, or the 'precision' option itself.
-	 * @param {sap.ui.core.Locale} [oLocale] Locale to get the formatter for
+	 * @param {sap.ui.core.Locale} [oLocale]
+	 *   The locale to get the formatter for; if no locale is given, a locale for the currently configured language is
+	 *   used; see {@link module:sap/base/i18n/Formatting.getLanguageTag Formatting.getLanguageTag}
 	 * @return {sap.ui.core.format.NumberFormat} float instance of the NumberFormat
 	 * @static
 	 * @public
@@ -416,9 +552,6 @@ sap.ui.define([
 	/**
 	 * Get an integer instance of the NumberFormat, which can be used for formatting.
 	 *
-	 * If no locale is given, the currently configured
-	 * {@link sap.ui.core.Configuration.FormatSettings#getFormatLocale formatLocale} will be used.
-	 *
 	 * <p>
 	 * This instance has TOWARDS_ZERO set as default rounding mode.
 	 * Please set the roundingMode property in oFormatOptions to change the
@@ -474,12 +607,14 @@ sap.ui.define([
 	 *   <code>maxFractionDigits</code> format option allows.
 	 *   If decimals are not preserved, the formatted number is rounded to <code>maxFractionDigits</code>.
 	 * @param {sap.ui.core.format.NumberFormat.RoundingMode} [oFormatOptions.roundingMode=TOWARDS_ZERO]
-	 *   specifies the rounding behavior for discarding the digits after the maximum fraction digits
-	 *   defined by maxFractionDigits. Rounding will only be applied if the passed value is of type <code>number</code>.
+	 *   Specifies the rounding behavior for discarding the digits after the maximum fraction digits
+	 *   defined by <code>maxFractionDigits</code>.
 	 *   This can be assigned
 	 *   <ul>
 	 *     <li>by value in {@link sap.ui.core.format.NumberFormat.RoundingMode RoundingMode},</li>
-	 *     <li>via a function that is used for rounding the number and takes two parameters: the number itself, and the number of decimal digits that should be reserved.</li>
+	 *     <li>via a function that is used for rounding the number and takes two parameters: the number itself, and the
+	 *         number of decimal digits that should be reserved. <b>Using a function is deprecated since 1.121.0</b>;
+	 *         string based numbers are not rounded via this custom function.</li>
 	 *   </ul>
 	 * @param {int} [oFormatOptions.shortDecimals] defines the number of decimal in the shortened format string. If this isn't specified, the 'decimals' options is used
 	 * @param {int} [oFormatOptions.shortLimit] only use short number formatting for values above this limit
@@ -493,7 +628,9 @@ sap.ui.define([
 	 *   numbers are formatted into compact forms. When this option is set, the default value of the
 	 *   'precision' option is set to 2. This can be changed by setting either min/maxFractionDigits,
 	 *   decimals, shortDecimals, or the 'precision' option itself.
-	 * @param {sap.ui.core.Locale} [oLocale] Locale to get the formatter for
+	 * @param {sap.ui.core.Locale} [oLocale]
+	 *   The locale to get the formatter for; if no locale is given, a locale for the currently configured language is
+	 *   used; see {@link module:sap/base/i18n/Formatting.getLanguageTag Formatting.getLanguageTag}
 	 * @return {sap.ui.core.format.NumberFormat} integer instance of the NumberFormat
 	 * @static
 	 * @public
@@ -509,9 +646,6 @@ sap.ui.define([
 	/**
 	 * Get a currency instance of the NumberFormat, which can be used for formatting.
 	 *
-	 * If no locale is given, the currently configured
-	 * {@link sap.ui.core.Configuration.FormatSettings#getFormatLocale formatLocale} will be used.
-	 *
 	 * <p>
 	 * This instance has HALF_AWAY_FROM_ZERO set as default rounding mode.
 	 * Please set the roundingMode property in oFormatOptions to change the
@@ -536,7 +670,9 @@ sap.ui.define([
 	 *
 	 * As an alternative to using a fixed <code>symbol</code> for your custom currencies, you can also provide an ISO-Code.
 	 * The provided ISO-Code will be used to look up the currency symbol in the global configuration,
-	 * either defined in the CLDR or custom defined on the Format Settings (see {@link sap.ui.core.Configuration.FormatSettings#setCustomCurrencies}, {@link sap.ui.core.Configuration.FormatSettings#addCustomCurrencies}).
+	 * either defined in the CLDR or custom defined on the Format Settings (see
+	 * {@link module:sap/base/i18n/Formatting.setCustomCurrencies Formatting.setCustomCurrencies},
+	 * {@link module:sap/base/i18n/Formatting.addCustomCurrencies Formatting.addCustomCurrencies}).
 	 *
 	 * If no symbol is given at all, the custom currency key is used for formatting.
 	 *
@@ -573,7 +709,8 @@ sap.ui.define([
 	 *   If custom currencies are defined on the instance, no other currencies can be formatted and parsed by this instance.
 	 *   Globally available custom currencies can be added via the global configuration.
 	 *   See the above examples.
-	 *   See also {@link sap.ui.core.Configuration.FormatSettings#setCustomCurrencies} and {@link sap.ui.core.Configuration.FormatSettings#addCustomCurrencies}.
+	 *   See also {@link module:sap/base/i18n/Formatting.setCustomCurrencies Formatting.setCustomCurrencies} and
+	 *   {@link module:sap/base/i18n/Formatting.addCustomCurrencies Formatting.addCustomCurrencies}.
 	 * @param {int} [oFormatOptions.decimals] defines the number of decimal digits
 	 * @param {string} [oFormatOptions.decimalSeparator] defines the character used as decimal separator.
 	 *   Note: <code>decimalSeparator</code> must always be different from <code>groupingSeparator</code>.
@@ -608,12 +745,14 @@ sap.ui.define([
 	 *   <code>maxFractionDigits</code> format option allows.
 	 *   If decimals are not preserved, the formatted number is rounded to <code>maxFractionDigits</code>.
 	 * @param {sap.ui.core.format.NumberFormat.RoundingMode} [oFormatOptions.roundingMode=HALF_AWAY_FROM_ZERO]
-	 *   specifies the rounding behavior for discarding the digits after the maximum fraction digits
-	 *   defined by maxFractionDigits. Rounding will only be applied if the passed value is of type <code>number</code>.
+	 *   Specifies the rounding behavior for discarding the digits after the maximum fraction digits
+	 *   defined by <code>maxFractionDigits</code>.
 	 *   This can be assigned
 	 *   <ul>
 	 *     <li>by value in {@link sap.ui.core.format.NumberFormat.RoundingMode RoundingMode},</li>
-	 *     <li>via a function that is used for rounding the number and takes two parameters: the number itself, and the number of decimal digits that should be reserved.</li>
+	 *     <li>via a function that is used for rounding the number and takes two parameters: the number itself, and the
+	 *         number of decimal digits that should be reserved. <b>Using a function is deprecated since 1.121.0</b>;
+	 *         string based numbers are not rounded via this custom function.</li>
 	 *   </ul>
 	 * @param {int} [oFormatOptions.shortDecimals] defines the number of decimal in the shortened format string. If this isn't specified, the 'decimals' options is used
 	 * @param {int} [oFormatOptions.shortLimit] only use short number formatting for values above this limit
@@ -637,11 +776,13 @@ sap.ui.define([
 	 *   'precision' option is set to 2. This can be changed by setting either min/maxFractionDigits,
 	 *   decimals, shortDecimals, or the 'precision' option itself.
 	 * @param {boolean} [oFormatOptions.trailingCurrencyCode] overrides the global configuration
-	 *   value {@link sap.ui.core.Configuration.FormatSettings#getTrailingCurrencyCode}, which has a
-	 *   default value of <code>true</>.
+	 *   value {@link module:sap/base/i18n/Formatting.getTrailingCurrencyCode Formatting.getTrailingCurrencyCode},
+	 *   which has a default value of <code>true</>.
 	 *   This is ignored if <code>oFormatOptions.currencyCode</code> is set to <code>false</code>,
 	 *   or if <code>oFormatOptions.pattern</code> is supplied.
-	 * @param {sap.ui.core.Locale} [oLocale] Locale to get the formatter for
+	 * @param {sap.ui.core.Locale} [oLocale]
+	 *   The locale to get the formatter for; if no locale is given, a locale for the currently configured language is
+	 *   used; see {@link module:sap/base/i18n/Formatting.getLanguageTag Formatting.getLanguageTag}
 	 * @return {sap.ui.core.format.NumberFormat} currency instance of the NumberFormat
 	 * @static
 	 * @public
@@ -681,9 +822,6 @@ sap.ui.define([
 	/**
 	 * Get a unit instance of the NumberFormat, which can be used for formatting units.
 	 *
-	 * If no locale is given, the currently configured
-	 * {@link sap.ui.core.Configuration.FormatSettings#getFormatLocale formatLocale} will be used.
-	 *
 	 * <p>
 	 * This instance has HALF_AWAY_FROM_ZERO set as default rounding mode.
 	 * Please set the roundingMode property in oFormatOptions to change the
@@ -738,12 +876,14 @@ sap.ui.define([
 	 *   <code>maxFractionDigits</code> format option allows.
 	 *   If decimals are not preserved, the formatted number is rounded to <code>maxFractionDigits</code>.
 	 * @param {sap.ui.core.format.NumberFormat.RoundingMode} [oFormatOptions.roundingMode=HALF_AWAY_FROM_ZERO]
-	 *   specifies the rounding behavior for discarding the digits after the maximum fraction digits
-	 *   defined by maxFractionDigits. Rounding will only be applied if the passed value is of type <code>number</code>.
+	 *   Specifies the rounding behavior for discarding the digits after the maximum fraction digits
+	 *   defined by <code>maxFractionDigits</code>.
 	 *   This can be assigned
 	 *   <ul>
 	 *     <li>by value in {@link sap.ui.core.format.NumberFormat.RoundingMode RoundingMode},</li>
-	 *     <li>via a function that is used for rounding the number and takes two parameters: the number itself, and the number of decimal digits that should be reserved.</li>
+	 *     <li>via a function that is used for rounding the number and takes two parameters: the number itself, and the
+	 *         number of decimal digits that should be reserved. <b>Using a function is deprecated since 1.121.0</b>;
+	 *         string based numbers are not rounded via this custom function.</li>
 	 *   </ul>
 	 * @param {int} [oFormatOptions.shortDecimals] defines the number of decimals in the shortened
 	 *   format string. If this option isn't specified, the 'decimals' option is used instead.
@@ -772,7 +912,9 @@ sap.ui.define([
 	 *   numbers are formatted into compact forms. When this option is set, the default value of the
 	 *   'precision' option is set to 2. This can be changed by setting either min/maxFractionDigits,
 	 *   decimals, shortDecimals, or the 'precision' option itself.
-	 * @param {sap.ui.core.Locale} [oLocale] Locale to get the formatter for
+	 * @param {sap.ui.core.Locale} [oLocale]
+	 *   The locale to get the formatter for; if no locale is given, a locale for the currently configured language is
+	 *   used; see {@link module:sap/base/i18n/Formatting.getLanguageTag Formatting.getLanguageTag}
 	 * @return {sap.ui.core.format.NumberFormat} unit instance of the NumberFormat
 	 * @static
 	 * @public
@@ -788,9 +930,6 @@ sap.ui.define([
 	/**
 	 * Get a percent instance of the NumberFormat, which can be used for formatting.
 	 *
-	 * If no locale is given, the currently configured
-	 * {@link sap.ui.core.Configuration.FormatSettings#getFormatLocale formatLocale} will be used.
-	 *
 	 * <p>
 	 * This instance has HALF_AWAY_FROM_ZERO set as default rounding mode.
 	 * Please set the roundingMode property in oFormatOptions to change the
@@ -836,12 +975,14 @@ sap.ui.define([
 	 *   <code>maxFractionDigits</code> format option allows.
 	 *   If decimals are not preserved, the formatted number is rounded to <code>maxFractionDigits</code>.
 	 * @param {sap.ui.core.format.NumberFormat.RoundingMode} [oFormatOptions.roundingMode=HALF_AWAY_FROM_ZERO]
-	 *   specifies the rounding behavior for discarding the digits after the maximum fraction digits
-	 *   defined by maxFractionDigits. Rounding will only be applied if the passed value is of type <code>number</code>.
+	 *   Specifies the rounding behavior for discarding the digits after the maximum fraction digits
+	 *   defined by <code>maxFractionDigits</code>.
 	 *   This can be assigned
 	 *   <ul>
 	 *     <li>by value in {@link sap.ui.core.format.NumberFormat.RoundingMode RoundingMode},</li>
-	 *     <li>via a function that is used for rounding the number and takes two parameters: the number itself, and the number of decimal digits that should be reserved.</li>
+	 *     <li>via a function that is used for rounding the number and takes two parameters: the number itself, and the
+	 *         number of decimal digits that should be reserved. <b>Using a function is deprecated since 1.121.0</b>;
+	 *         string based numbers are not rounded via this custom function.</li>
 	 *   </ul>
 	 * @param {int} [oFormatOptions.shortDecimals] defines the number of decimal in the shortened format string. If this isn't specified, the 'decimals' options is used
 	 * @param {int} [oFormatOptions.shortLimit] only use short number formatting for values above this limit
@@ -855,7 +996,9 @@ sap.ui.define([
 	 *   numbers are formatted into compact forms. When this option is set, the default value of the
 	 *   'precision' option is set to 2. This can be changed by setting either min/maxFractionDigits,
 	 *   decimals, shortDecimals, or the 'precision' option itself.
-	 * @param {sap.ui.core.Locale} [oLocale] Locale to get the formatter for
+	 * @param {sap.ui.core.Locale} [oLocale]
+	 *   The locale to get the formatter for; if no locale is given, a locale for the currently configured language is
+	 *   used; see {@link module:sap/base/i18n/Formatting.getLanguageTag Formatting.getLanguageTag}
 	 * @return {sap.ui.core.format.NumberFormat} percentage instance of the NumberFormat
 	 * @static
 	 * @public
@@ -884,7 +1027,7 @@ sap.ui.define([
 			oFormatOptions = undefined;
 		}
 		if (!oLocale) {
-			oLocale = Configuration.getFormatSettings().getFormatLocale();
+			oLocale = new Locale(Formatting.getLanguageTag());
 		}
 		oFormat.oLocale = oLocale;
 		oFormat.oLocaleData = LocaleData.getInstance(oLocale);
@@ -1421,7 +1564,8 @@ sap.ui.define([
 		// If the number of fraction digits are equal or less than oOptions.maxFractionDigits, the
 		// number isn't changed. After this operation, the number of fraction digits is
 		// equal or less than oOptions.maxFractionDigits.
-		if (typeof vValue === "number" && !oOptions.preserveDecimals) {
+		if ((typeof vValue === "number" || typeof vValue === "string" && typeof oOptions.roundingMode !== "function")
+				&& !oOptions.preserveDecimals) {
 			vValue = rounding(vValue, oOptions.maxFractionDigits, oOptions.roundingMode);
 		}
 
@@ -1761,6 +1905,12 @@ sap.ui.define([
 			vResult = 0,
 			oShort, vEmptyParseValue;
 
+		if (typeof sValue !== "string" && !(sValue instanceof String)) {
+			return null;
+		}
+
+		sValue = FormatUtils.normalize(sValue).trim();
+
 		if (sValue === "") {
 			if (!oOptions.showNumber) {
 				return null;
@@ -1778,10 +1928,6 @@ sap.ui.define([
 			}
 		}
 
-		if (typeof sValue !== "string" && !(sValue instanceof String)) {
-			return null;
-		}
-
 		if (oOptions.groupingSeparator === oOptions.decimalSeparator) {
 			Log.error("The grouping and decimal separator both have the same value '" + oOptions.groupingSeparator + "'. " +
 				"They must be different from each other such that values can be parsed correctly.");
@@ -1901,9 +2047,6 @@ sap.ui.define([
 			}
 		}
 
-		// remove the RTL special characters before the string is matched with the regex
-		sValue = sValue.replace(/[\u202a\u200e\u202c\u202b\u200f]/g, "");
-
 		// remove all white spaces because when grouping separator is a non-breaking space (russian and french for example)
 		// user will not input it this way. Also white spaces or grouping separator can be ignored by determining the value
 		sValue = sValue.replace(rAllWhiteSpaces, "");
@@ -2042,10 +2185,22 @@ sap.ui.define([
 		}
 	};
 
-	NumberFormat._shiftDecimalPoint = function(vValue, iStep) {
-		if (typeof iStep !== "number") {
-			return NaN;
-		}
+	/**
+	 * Moves the decimal seperator of the given number by the given steps to the right or left.
+	 *
+	 * @param {number|string} vValue
+	 *   The number
+	 * @param {int} iStep
+	 *   The number of decimal places to shift the "."; positive values shift to the right, negative values shift to the
+	 *   left
+	 * @param {boolean} bNormalize
+	 *   Whether the result is normalized if <code>vValue</code> is of type "string"; that means whether trailing zeros
+	 *   are removed and whether scientific notation is resolved to a decimal string without exponent
+	 * @returns {number|string|null}
+	 *   The number with shifted decimal point; or <code>null</code> if the given value is neither of type "number", nor
+	 *   of type "string"
+	 */
+	NumberFormat._shiftDecimalPoint = function(vValue, iStep, bNormalize) {
 		var sMinus = "";
 		var aExpParts = vValue.toString().toLowerCase().split("e");
 
@@ -2058,7 +2213,7 @@ sap.ui.define([
 
 			return +(aExpParts[0] + "e" + iStep);
 		} else if (typeof vValue === "string") {
-			if (parseFloat(vValue) === 0 && iStep >= 0) {
+			if (!bNormalize && parseFloat(vValue) === 0 && iStep >= 0) {
 				// input "00000" should become "0"
 				// input "000.000" should become "0.000" to keep precision of decimals
 				// input "1e-1337" should remain "1e-1337" in order to keep the precision
@@ -2070,7 +2225,7 @@ sap.ui.define([
 			var sFirstChar = aExpParts[0].charAt(0);
 			sMinus = sFirstChar === "-" ? sFirstChar : "";
 
-			if (sMinus) {
+			if (sMinus || sFirstChar === "+") {
 				aExpParts[0] = aExpParts[0].slice(1);
 			}
 
@@ -2109,9 +2264,11 @@ sap.ui.define([
 
 			sInt = vValue.substring(0, iAfterMovePos);
 			sDecimal = vValue.substring(iAfterMovePos);
-
 			// remove unnecessary leading zeros
 			sInt = sInt.replace(rLeadingZeros, "$1$2");
+			if (bNormalize) {
+				sDecimal = sDecimal.replace(rTrailingZeros, "");
+			}
 
 			return sMinus + sInt + (sDecimal ? ("." + sDecimal) : "");
 		} else {
@@ -2203,9 +2360,8 @@ sap.ui.define([
 				}
 
 				if (sCldrFormat) {
-					// Note: CLDR uses a non-breaking space in the format string
-					// remove right-to-left mark u+200f character
-					sCldrFormat = sCldrFormat.replace(/[\s\u00a0\u200F]/g, "");
+					// Note: CLDR uses a non-breaking space and right-to-left mark u+200f in the format string
+					sCldrFormat = FormatUtils.normalize(sCldrFormat, true);
 					//formatString may contain '.' (quoted to differentiate them decimal separator)
 					//which must be replaced with .
 					sCldrFormat = sCldrFormat.replace(/'.'/g, ".");
@@ -2222,8 +2378,6 @@ sap.ui.define([
 						if (iIndex >= 0) {
 							// parse the number part like every other number and then use the factor to get the real number
 							sNumber = sValue.replace(sUnit, "");
-							// remove right-to-left mark u+200f character
-							sNumber = sNumber.replace(/\u200F/g, "");
 							iFactor = iKey;
 							// spanish numbers e.g. for MRD in format for "one" is "00 MRD" therefore factor needs to be adjusted
 							// german numbers e.g. for Mrd. in format for "one" is "0 Mrd." therefore number does not need to be adjusted
@@ -2282,7 +2436,7 @@ sap.ui.define([
 	 * @returns {boolean}
 	 */
 	function showTrailingCurrencyCode(oFormatOptions) {
-		var bShowTrailingCurrencyCodes = Configuration.getFormatSettings().getTrailingCurrencyCode();
+		var bShowTrailingCurrencyCodes = Formatting.getTrailingCurrencyCode();
 		if (oFormatOptions) {
 
 			// overwritten by instance configuration
@@ -2581,54 +2735,63 @@ sap.ui.define([
 		return iInt;
 	}
 
-	function rounding(fValue, iMaxFractionDigits, sRoundingMode) {
-		if (typeof fValue !== "number") {
-			return NaN;
-		}
-
-		sRoundingMode = sRoundingMode || NumberFormat.RoundingMode.HALF_AWAY_FROM_ZERO;
+	/**
+	 * Rounds the given value by the given number of fraction digits based on the given rounding mode.
+	 *
+	 * @param {number|string} vValue
+	 *   The number to be rounded, may be a string or a number; has to be of type number if a custom rounding function
+	 *   is used
+	 * @param {int|string} iMaxFractionDigits
+	 *   The maximum number of fraction digits
+	 * @param {sap.ui.core.format.NumberFormat.RoundingMode|function(number,int):number} vRoundingMode
+	 *   The rounding mode or a custom function for rounding which is called with the number and the number of decimal
+	 *   digits that should be reserved; <b>using a function is deprecated since 1.121.0</b>; string based numbers are
+	 *   not rounded via this custom function.
+	 * @returns {number|string}
+	 *   The rounded value; the returned type is the same as the type of the given <code>vValue</code>
+	 */
+	function rounding(vValue, iMaxFractionDigits, vRoundingMode) {
+		vRoundingMode = vRoundingMode || NumberFormat.RoundingMode.HALF_AWAY_FROM_ZERO;
 		iMaxFractionDigits = parseInt(iMaxFractionDigits);
 
 		// only round if it is required (number of fraction digits is bigger than the maxFractionDigits option)
-		var sValue = "" + fValue;
+		var sValue = "" + vValue;
 		if (!isScientificNotation(sValue)) {
 			var iIndexOfPoint = sValue.indexOf(".");
 			if (iIndexOfPoint < 0) {
-				return fValue;
+				return vValue;
 			}
 			if (sValue.substring(iIndexOfPoint + 1).length <= iMaxFractionDigits) {
-				return fValue;
+				if (typeof vValue === "string") {
+					vValue = NumberFormat._shiftDecimalPoint(vValue, 0, true);
+				}
+				return vValue;
 			}
 		}
 
-		if (typeof sRoundingMode === "function") {
+		if (typeof vRoundingMode === "function") {
 			// Support custom function for rounding the number
-			fValue = sRoundingMode(fValue, iMaxFractionDigits);
+			vValue = vRoundingMode(vValue, iMaxFractionDigits);
 		} else {
 			// The NumberFormat.RoundingMode had all values in lower case before and later changed all values to upper case
 			// to match the key according to the UI5 guideline for defining enum. Therefore it's needed to support both
 			// lower and upper cases. Here checks whether the value has only lower case letters and converts it all to upper
 			// case if so.
-			if (sRoundingMode.match(/^[a-z_]+$/)) {
-				sRoundingMode = sRoundingMode.toUpperCase();
+			if (vRoundingMode.match(/^[a-z_]+$/)) {
+				vRoundingMode = vRoundingMode.toUpperCase();
 			}
 
-			if (!iMaxFractionDigits) {
-				return mRoundingFunction[sRoundingMode](fValue);
+			// 1. Move the decimal point to right by maxFactionDigits; e.g. 1.005 with maxFractionDigits 2 => 100.5
+			vValue = NumberFormat._shiftDecimalPoint(vValue, iMaxFractionDigits, true);
+			// 2. Use the rounding function to round the first digit after decimal point; e.g. ceil(100.5) => 101
+			vValue = mRoundingFunction[vRoundingMode](vValue);
+			// 3. Finally move the decimal point back to the original position; e.g. by 2 digits => 1.01
+			vValue = NumberFormat._shiftDecimalPoint(vValue, -iMaxFractionDigits, true);
+			if (typeof vValue === "string") {
+				vValue = vValue.replace(rRemoveMinusFromZero, "$1");
 			}
-
-			// First move the decimal point towards right by maxFactionDigits
-			// Then using the rounding function to round the first digit after decimal point
-			// In the end, move the decimal point back to the original position
-			//
-			// For example rounding 1.005 by maxFractionDigits 2
-			// 	1. Move the decimal point to right by 2 digits, result 100.5
-			// 	2. Using the round function, for example, Math.round(100.5) = 101
-			// 	3. Move the decimal point back by 2 digits, result 1.01
-			fValue = NumberFormat._shiftDecimalPoint(mRoundingFunction[sRoundingMode](NumberFormat._shiftDecimalPoint(fValue, iMaxFractionDigits)), -iMaxFractionDigits);
 		}
-
-		return fValue;
+		return vValue;
 	}
 
 	function quote(sRegex) {
@@ -2680,7 +2843,7 @@ sap.ui.define([
 				if (!sKey.startsWith("unitPattern")) {
 					continue;
 				}
-				sUnitPattern = mUnitPatterns[sUnitCode][sKey];
+				sUnitPattern = FormatUtils.normalize(mUnitPatterns[sUnitCode][sKey]);
 
 				// IMPORTANT:
 				// To increase performance we are using native string operations instead of regex,
@@ -2809,7 +2972,7 @@ sap.ui.define([
 			if (!sCurSymbol) {
 				continue;
 			}
-			sCurSymbol = sCurSymbol.replace(rAllWhiteSpaces, "\u0020");
+			sCurSymbol = FormatUtils.normalize(sCurSymbol);
 			if (sValue.indexOf(sCurSymbol) >= 0 && sSymbol.length <= sCurSymbol.length) {
 				sCode = sCurCode;
 				bDuplicate = false;
@@ -2817,7 +2980,7 @@ sap.ui.define([
 				sSymbol = sCurSymbol;
 				sRecognizedCurrency = sCurSymbol;
 			} else if (bCaseInsensitive) {
-				sLanguageTag = Configuration.getLanguageTag();
+				sLanguageTag = Localization.getLanguageTag().toString();
 				sCurSymbolToUpperCase = sCurSymbol.toLocaleUpperCase(sLanguageTag);
 				iIndex = sValue.toLocaleUpperCase(sLanguageTag).indexOf(sCurSymbolToUpperCase);
 				if (iIndex >= 0) {
@@ -2869,7 +3032,7 @@ sap.ui.define([
 	 */
 	function parseNumberAndCurrency(oConfig) {
 		var aIsoMatches,
-			sValue = oConfig.value.replace(rAllWhiteSpaces, "\u0020");
+			sValue = oConfig.value;
 
 		// Search for known symbols (longest match)
 		// no distinction between default and custom currencies
@@ -2885,7 +3048,7 @@ sap.ui.define([
 				// Match 3-letter iso code
 				aIsoMatches = sValue.match(/(^[A-Z]{3}|[A-Z]{3}$)/i);
 				oMatch.code = aIsoMatches
-					&& aIsoMatches[0].toLocaleUpperCase(Configuration.getLanguageTag());
+					&& aIsoMatches[0].toLocaleUpperCase(Localization.getLanguageTag().toString());
 				oMatch.recognizedCurrency = aIsoMatches && aIsoMatches[0];
 			}
 		}