@ui5/webcomponents-localization 0.0.0-2c7615fe9 → 0.0.0-2f7664755

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

@@ -1,17 +1,32 @@
-import Core from '../Core.js';
 import CalendarType from '../CalendarType.js';
 import Locale from '../Locale.js';
 import LocaleData from '../LocaleData.js';
 import UniversalDate from '../date/UniversalDate.js';
+import CalendarUtils from '../date/CalendarUtils.js';
+import CalendarWeekNumbering from '../date/CalendarWeekNumbering.js';
+import TimezoneUtil from './TimezoneUtil.js';
 import deepEqual from '../../../base/util/deepEqual.js';
 import formatMessage from '../../../base/strings/formatMessage.js';
 import Log from '../../../base/Log.js';
 import extend from '../../../base/util/extend.js';
+import Configuration from '../Configuration.js';
 var DateFormat = function () {
     throw new Error();
 };
+var mDateFormatTypes = {
+    DATE: 'date',
+    TIME: 'time',
+    DATETIME: 'datetime',
+    DATETIME_WITH_TIMEZONE: 'datetimeWithTimezone'
+};
 var mCldrDatePattern = {};
+var checkTimezoneParameterType = function (sTimezone) {
+    if (typeof sTimezone !== 'string' && !(sTimezone instanceof String) && sTimezone != null) {
+        throw new TypeError('The given timezone must be a string.');
+    }
+};
 DateFormat.oDateInfo = {
+    type: mDateFormatTypes.DATE,
     oDefaultFormatOptions: {
         style: 'medium',
         relativeScale: 'day',
@@ -64,6 +79,7 @@ DateFormat.oDateInfo = {
     ]
 };
 DateFormat.oDateTimeInfo = {
+    type: mDateFormatTypes.DATETIME,
     oDefaultFormatOptions: {
         style: 'medium',
         relativeScale: 'auto',
@@ -126,7 +142,41 @@ DateFormat.oDateTimeInfo = {
         'Seconds'
     ]
 };
+DateFormat._getDateTimeWithTimezoneInfo = function (oFormatOptions) {
+    var bShowDate = oFormatOptions.showDate === undefined || oFormatOptions.showDate;
+    var bShowTime = oFormatOptions.showTime === undefined || oFormatOptions.showTime;
+    var bShowTimezone = oFormatOptions.showTimezone === undefined || oFormatOptions.showTimezone;
+    var oBaselineType = DateFormat.oDateTimeInfo;
+    if (bShowDate && !bShowTime) {
+        oBaselineType = DateFormat.oDateInfo;
+    } else if (!bShowDate && bShowTime) {
+        oBaselineType = DateFormat.oTimeInfo;
+    }
+    return Object.assign({}, oBaselineType, {
+        type: mDateFormatTypes.DATETIME_WITH_TIMEZONE,
+        getTimezonePattern: function (sPattern) {
+            if (!bShowDate && !bShowTime && bShowTimezone) {
+                return 'VV';
+            } else if (!bShowTimezone) {
+                return sPattern;
+            } else {
+                return sPattern + ' VV';
+            }
+        },
+        getPattern: function (oLocaleData, sStyle, sCalendarType) {
+            if (!bShowDate && !bShowTime && bShowTimezone) {
+                return 'VV';
+            }
+            if (!bShowTimezone) {
+                return oBaselineType.getPattern(oLocaleData, sStyle, sCalendarType);
+            }
+            var sPattern = oBaselineType.getPattern(oLocaleData, sStyle, sCalendarType);
+            return oLocaleData.applyTimezonePattern(sPattern);
+        }
+    });
+};
 DateFormat.oTimeInfo = {
+    type: mDateFormatTypes.TIME,
     oDefaultFormatOptions: {
         style: 'medium',
         relativeScale: 'auto',
@@ -179,6 +229,27 @@ DateFormat.getDateInstance = function (oFormatOptions, oLocale) {
 DateFormat.getDateTimeInstance = function (oFormatOptions, oLocale) {
     return this.createInstance(oFormatOptions, oLocale, this.oDateTimeInfo);
 };
+DateFormat.getDateTimeWithTimezoneInstance = function (oFormatOptions, oLocale) {
+    if (oFormatOptions && !(oFormatOptions instanceof Locale)) {
+        oFormatOptions = Object.assign({}, oFormatOptions);
+        if (typeof oFormatOptions.showTimezone === 'string') {
+            var sShowTimezone = oFormatOptions.showTimezone;
+            if (oFormatOptions.showDate === undefined && oFormatOptions.showTime === undefined) {
+                if (sShowTimezone === 'Hide') {
+                    oFormatOptions.showTimezone = false;
+                } else if (sShowTimezone === 'Only') {
+                    oFormatOptions.showDate = false;
+                    oFormatOptions.showTime = false;
+                }
+            }
+            oFormatOptions.showTimezone = sShowTimezone !== 'Hide';
+        }
+        if (oFormatOptions.showDate === false && oFormatOptions.showTime === false && oFormatOptions.showTimezone === false) {
+            throw new TypeError('Invalid Configuration. One of the following format options must be true: showDate, showTime or showTimezone.');
+        }
+    }
+    return this.createInstance(oFormatOptions, oLocale, DateFormat._getDateTimeWithTimezoneInfo(oFormatOptions || {}));
+};
 DateFormat.getTimeInstance = function (oFormatOptions, oLocale) {
     return this.createInstance(oFormatOptions, oLocale, this.oTimeInfo);
 };
@@ -194,13 +265,29 @@ DateFormat.createInstance = function (oFormatOptions, oLocale, oInfo) {
         oFormatOptions = undefined;
     }
     if (!oLocale) {
-        oLocale = Core.getConfiguration().getFormatSettings().getFormatLocale();
+        oLocale = Configuration.getFormatSettings().getFormatLocale();
     }
     oFormat.oLocale = oLocale;
     oFormat.oLocaleData = LocaleData.getInstance(oLocale);
     oFormat.oFormatOptions = extend({}, oInfo.oDefaultFormatOptions, oFormatOptions);
+    if (oInfo.type === mDateFormatTypes.DATETIME_WITH_TIMEZONE) {
+        oFormat.oFormatOptions.interval = false;
+        oFormat.oFormatOptions.singleIntervalValue = false;
+        oFormat.oFormatOptions.UTC = false;
+    } else {
+        oFormat.oFormatOptions.showTimezone = undefined;
+        oFormat.oFormatOptions.showDate = undefined;
+        oFormat.oFormatOptions.showTime = undefined;
+    }
+    oFormat.type = oInfo.type;
     if (!oFormat.oFormatOptions.calendarType) {
-        oFormat.oFormatOptions.calendarType = Core.getConfiguration().getCalendarType();
+        oFormat.oFormatOptions.calendarType = Configuration.getCalendarType();
+    }
+    if (oFormat.oFormatOptions.firstDayOfWeek === undefined && oFormat.oFormatOptions.minimalDaysInFirstWeek !== undefined || oFormat.oFormatOptions.firstDayOfWeek !== undefined && oFormat.oFormatOptions.minimalDaysInFirstWeek === undefined) {
+        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) {
         if (oFormat.oFormatOptions.format) {
@@ -246,7 +333,7 @@ DateFormat.createInstance = function (oFormatOptions, oLocale, oInfo) {
             if (oFormat.oFormatOptions.pattern && oInfo.bPatternFallbackWithoutDelimiter) {
                 aFallbackFormatOptions = DateFormat._createFallbackOptionsWithoutDelimiter(oFormat.oFormatOptions.pattern).concat(aFallbackFormatOptions);
             }
-            oFallbackFormats = DateFormat._createFallbackFormat(aFallbackFormatOptions, sCalendarType, oLocale, oInfo, oFormat.oFormatOptions.interval);
+            oFallbackFormats = DateFormat._createFallbackFormat(aFallbackFormatOptions, sCalendarType, oLocale, oInfo, oFormat.oFormatOptions);
         }
         oFormat.aFallbackFormats = oFallbackFormats;
     }
@@ -282,14 +369,28 @@ DateFormat.prototype.init = function () {
     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.oFlexibleDayPeriodsAbbrev = this.oLocaleData.getFlexibleDayPeriods('abbreviated', sCalendarType);
+    this.oFlexibleDayPeriodsNarrow = this.oLocaleData.getFlexibleDayPeriods('narrow', sCalendarType);
+    this.oFlexibleDayPeriodsWide = this.oLocaleData.getFlexibleDayPeriods('wide', sCalendarType);
+    this.oFlexibleDayPeriodsAbbrevSt = this.oLocaleData.getFlexibleDayPeriodsStandAlone('abbreviated', sCalendarType);
+    this.oFlexibleDayPeriodsNarrowSt = this.oLocaleData.getFlexibleDayPeriodsStandAlone('narrow', sCalendarType);
+    this.oFlexibleDayPeriodsWideSt = this.oLocaleData.getFlexibleDayPeriodsStandAlone('wide', sCalendarType);
     this.aFormatArray = this.parseCldrDatePattern(this.oFormatOptions.pattern);
     this.sAllowedCharacters = this.getAllowedCharacters(this.aFormatArray);
 };
-DateFormat._createFallbackFormat = function (aFallbackFormatOptions, sCalendarType, oLocale, oInfo, bInterval) {
+DateFormat._createFallbackFormat = function (aFallbackFormatOptions, sCalendarType, oLocale, oInfo, oParentFormatOptions) {
     return aFallbackFormatOptions.map(function (oOptions) {
         var oFormatOptions = Object.assign({}, oOptions);
-        if (bInterval) {
+        oFormatOptions.showDate = oParentFormatOptions.showDate;
+        oFormatOptions.showTime = oParentFormatOptions.showTime;
+        oFormatOptions.showTimezone = oParentFormatOptions.showTimezone;
+        if (typeof oInfo.getTimezonePattern === 'function' && oFormatOptions.pattern) {
+            oFormatOptions.pattern = oInfo.getTimezonePattern(oFormatOptions.pattern);
+        }
+        if (oParentFormatOptions.interval) {
             oFormatOptions.interval = true;
         }
         oFormatOptions.calendarType = sCalendarType;
@@ -337,17 +438,32 @@ var oParseHelper = {
         }
         return sValue.substr(0, iLength);
     },
-    findEntry: function (sValue, aList) {
+    startsWithIgnoreCase: function (sValue, sSubstring, sLocale) {
+        if (sValue.startsWith(sSubstring)) {
+            return true;
+        }
+        try {
+            var sSubToLocaleUpperCase = sSubstring.toLocaleUpperCase(sLocale);
+            var sValueUpperCase = sValue.toLocaleUpperCase(sLocale);
+            if (sSubToLocaleUpperCase.length !== sSubstring.length || sValueUpperCase.length !== sValue.length) {
+                return false;
+            }
+            return sValueUpperCase.startsWith(sSubToLocaleUpperCase);
+        } catch (e) {
+            return false;
+        }
+    },
+    findEntry: function (sValue, aList, sLocale) {
         var iFoundIndex = -1, iMatchedLength = 0;
         for (var j = 0; j < aList.length; j++) {
-            if (aList[j] && aList[j].length > iMatchedLength && sValue.indexOf(aList[j]) === 0) {
+            if (aList[j] && aList[j].length > iMatchedLength && this.startsWithIgnoreCase(sValue, aList[j], sLocale)) {
                 iFoundIndex = j;
                 iMatchedLength = aList[j].length;
             }
         }
         return {
             index: iFoundIndex,
-            value: iFoundIndex === -1 ? null : aList[iFoundIndex]
+            length: iMatchedLength
         };
     },
     parseTZ: function (sValue, bColonSeparated) {
@@ -369,7 +485,7 @@ var oParseHelper = {
         }
         return {
             length: iLength,
-            tzDiff: (iTZDiff + 60 * iTZDiffHour) * iTZFactor
+            tzDiff: (iTZDiff + 60 * iTZDiffHour) * 60 * iTZFactor
         };
     },
     checkValid: function (sType, bPartInvalid, oFormat) {
@@ -381,7 +497,7 @@ var oParseHelper = {
 DateFormat.prototype.oSymbols = {
     '': {
         name: 'text',
-        format: function (oField, oDate, bUTC, oFormat) {
+        format: function (oField, oDate) {
             return oField.value;
         },
         parse: function (sValue, oPart, oFormat, oConfig) {
@@ -425,7 +541,7 @@ DateFormat.prototype.oSymbols = {
     'G': {
         name: 'era',
         format: function (oField, oDate, bUTC, oFormat) {
-            var iEra = bUTC ? oDate.getUTCEra() : oDate.getEra();
+            var iEra = oDate.getUTCEra();
             if (oField.digits <= 3) {
                 return oFormat.aErasAbbrev[iEra];
             } else if (oField.digits === 4) {
@@ -442,11 +558,11 @@ DateFormat.prototype.oSymbols = {
             ];
             for (var i = 0; i < aErasVariants.length; i++) {
                 var aVariants = aErasVariants[i];
-                var oFound = oParseHelper.findEntry(sValue, aVariants);
+                var oFound = oParseHelper.findEntry(sValue, aVariants, oFormat.oLocaleData.sCLDRLocaleId);
                 if (oFound.index !== -1) {
                     return {
                         era: oFound.index,
-                        length: oFound.value.length
+                        length: oFound.length
                     };
                 }
             }
@@ -459,7 +575,7 @@ DateFormat.prototype.oSymbols = {
     'y': {
         name: 'year',
         format: function (oField, oDate, bUTC, oFormat) {
-            var iYear = bUTC ? oDate.getUTCFullYear() : oDate.getFullYear();
+            var iYear = oDate.getUTCFullYear();
             var sYear = String(iYear);
             var sCalendarType = oFormat.oFormatOptions.calendarType;
             if (oField.digits == 2 && sYear.length > 2) {
@@ -482,7 +598,7 @@ DateFormat.prototype.oSymbols = {
             }
             var iYear = parseInt(sPart);
             if (sCalendarType != CalendarType.Japanese && sPart.length <= 2) {
-                var oCurrentDate = UniversalDate.getInstance(new Date(), sCalendarType), iCurrentYear = oCurrentDate.getFullYear(), iCurrentCentury = Math.floor(iCurrentYear / 100), iYearDiff = iCurrentCentury * 100 + iYear - iCurrentYear;
+                var oCurrentDate = UniversalDate.getInstance(new Date(), sCalendarType), iCurrentYear = oCurrentDate.getUTCFullYear(), iCurrentCentury = Math.floor(iCurrentYear / 100), iYearDiff = iCurrentCentury * 100 + iYear - iCurrentYear;
                 if (iYearDiff < -70) {
                     iYear += (iCurrentCentury + 1) * 100;
                 } else if (iYearDiff < 30) {
@@ -501,7 +617,7 @@ DateFormat.prototype.oSymbols = {
     'Y': {
         name: 'weekYear',
         format: function (oField, oDate, bUTC, oFormat) {
-            var oWeek = bUTC ? oDate.getUTCWeek() : oDate.getWeek();
+            var oWeek = oDate.getUTCWeek(oFormat.oLocale, getCalendarWeekParameter(oFormat.oFormatOptions));
             var iWeekYear = oWeek.year;
             var sWeekYear = String(iWeekYear);
             var sCalendarType = oFormat.oFormatOptions.calendarType;
@@ -524,9 +640,9 @@ DateFormat.prototype.oSymbols = {
                 sPart = oParseHelper.findNumbers(sValue, oPart.digits);
             }
             var iYear = parseInt(sPart);
-            var iWeekYear;
+            var iWeekYear = iYear;
             if (sCalendarType != CalendarType.Japanese && sPart.length <= 2) {
-                var oCurrentDate = UniversalDate.getInstance(new Date(), sCalendarType), iCurrentYear = oCurrentDate.getFullYear(), iCurrentCentury = Math.floor(iCurrentYear / 100), iYearDiff = iCurrentCentury * 100 + iWeekYear - iCurrentYear;
+                var oCurrentDate = UniversalDate.getInstance(new Date(), sCalendarType), iCurrentYear = oCurrentDate.getUTCFullYear(), iCurrentCentury = Math.floor(iCurrentYear / 100), iYearDiff = iCurrentCentury * 100 + iWeekYear - iCurrentYear;
                 if (iYearDiff < -70) {
                     iWeekYear += (iCurrentCentury + 1) * 100;
                 } else if (iYearDiff < 30) {
@@ -546,7 +662,7 @@ DateFormat.prototype.oSymbols = {
     'M': {
         name: 'month',
         format: function (oField, oDate, bUTC, oFormat) {
-            var iMonth = bUTC ? oDate.getUTCMonth() : oDate.getMonth();
+            var iMonth = oDate.getUTCMonth();
             if (oField.digits == 3) {
                 return oFormat.aMonthsAbbrev[iMonth];
             } else if (oField.digits == 4) {
@@ -579,11 +695,11 @@ DateFormat.prototype.oSymbols = {
             } else {
                 for (var i = 0; i < aMonthsVariants.length; i++) {
                     var aVariants = aMonthsVariants[i];
-                    var oFound = oParseHelper.findEntry(sValue, aVariants);
+                    var oFound = oParseHelper.findEntry(sValue, aVariants, oFormat.oLocaleData.sCLDRLocaleId);
                     if (oFound.index !== -1) {
                         return {
                             month: oFound.index,
-                            length: oFound.value.length
+                            length: oFound.length
                         };
                     }
                 }
@@ -599,7 +715,7 @@ DateFormat.prototype.oSymbols = {
     'L': {
         name: 'monthStandalone',
         format: function (oField, oDate, bUTC, oFormat) {
-            var iMonth = bUTC ? oDate.getUTCMonth() : oDate.getMonth();
+            var iMonth = oDate.getUTCMonth();
             if (oField.digits == 3) {
                 return oFormat.aMonthsAbbrevSt[iMonth];
             } else if (oField.digits == 4) {
@@ -632,11 +748,11 @@ DateFormat.prototype.oSymbols = {
             } else {
                 for (var i = 0; i < aMonthsVariants.length; i++) {
                     var aVariants = aMonthsVariants[i];
-                    var oFound = oParseHelper.findEntry(sValue, aVariants);
+                    var oFound = oParseHelper.findEntry(sValue, aVariants, oFormat.oLocaleData.sCLDRLocaleId);
                     if (oFound.index !== -1) {
                         return {
                             month: oFound.index,
-                            length: oFound.value.length
+                            length: oFound.length
                         };
                     }
                 }
@@ -652,7 +768,7 @@ DateFormat.prototype.oSymbols = {
     'w': {
         name: 'weekInYear',
         format: function (oField, oDate, bUTC, oFormat) {
-            var oWeek = bUTC ? oDate.getUTCWeek() : oDate.getWeek();
+            var oWeek = oDate.getUTCWeek(oFormat.oLocale, getCalendarWeekParameter(oFormat.oFormatOptions));
             var iWeek = oWeek.week;
             var sWeek = String(iWeek + 1);
             if (oField.digits < 3) {
@@ -674,11 +790,11 @@ DateFormat.prototype.oSymbols = {
                 bValid = oParseHelper.checkValid(oPart.type, !sPart, oFormat);
             } else {
                 sPart = oFormat.oLocaleData.getCalendarWeek(oPart.digits === 3 ? 'narrow' : 'wide');
-                sPart = sPart.replace('{0}', '[0-9]+');
+                sPart = sPart.replace('{0}', '([0-9]+)');
                 var rWeekNumber = new RegExp(sPart), oResult = rWeekNumber.exec(sValue);
                 if (oResult) {
                     iLength = oResult[0].length;
-                    iWeek = parseInt(oResult[0]) - 1;
+                    iWeek = parseInt(oResult[oResult.length - 1]) - 1;
                 } else {
                     bValid = oParseHelper.checkValid(oPart.type, true, oFormat);
                 }
@@ -692,7 +808,7 @@ DateFormat.prototype.oSymbols = {
     },
     'W': {
         name: 'weekInMonth',
-        format: function (oField, oDate, bUTC, oFormat) {
+        format: function (oField, oDate) {
             return '';
         },
         parse: function () {
@@ -701,7 +817,7 @@ DateFormat.prototype.oSymbols = {
     },
     'D': {
         name: 'dayInYear',
-        format: function (oField, oDate, bUTC, oFormat) {
+        format: function (oField, oDate) {
         },
         parse: function () {
             return {};
@@ -709,8 +825,8 @@ DateFormat.prototype.oSymbols = {
     },
     'd': {
         name: 'day',
-        format: function (oField, oDate, bUTC, oFormat) {
-            var iDate = bUTC ? oDate.getUTCDate() : oDate.getDate();
+        format: function (oField, oDate) {
+            var iDate = oDate.getUTCDate();
             return String(iDate).padStart(oField.digits, '0');
         },
         parse: function (sValue, oPart, oFormat, oConfig) {
@@ -730,7 +846,7 @@ DateFormat.prototype.oSymbols = {
     'Q': {
         name: 'quarter',
         format: function (oField, oDate, bUTC, oFormat) {
-            var iQuarter = bUTC ? oDate.getUTCQuarter() : oDate.getQuarter();
+            var iQuarter = oDate.getUTCQuarter();
             if (oField.digits == 3) {
                 return oFormat.aQuartersAbbrev[iQuarter];
             } else if (oField.digits == 4) {
@@ -763,11 +879,11 @@ DateFormat.prototype.oSymbols = {
             } else {
                 for (var i = 0; i < aQuartersVariants.length; i++) {
                     var aVariants = aQuartersVariants[i];
-                    var oFound = oParseHelper.findEntry(sValue, aVariants);
+                    var oFound = oParseHelper.findEntry(sValue, aVariants, oFormat.oLocaleData.sCLDRLocaleId);
                     if (oFound.index !== -1) {
                         return {
                             quarter: oFound.index,
-                            length: oFound.value.length
+                            length: oFound.length
                         };
                     }
                 }
@@ -783,7 +899,7 @@ DateFormat.prototype.oSymbols = {
     'q': {
         name: 'quarterStandalone',
         format: function (oField, oDate, bUTC, oFormat) {
-            var iQuarter = bUTC ? oDate.getUTCQuarter() : oDate.getQuarter();
+            var iQuarter = oDate.getUTCQuarter();
             if (oField.digits == 3) {
                 return oFormat.aQuartersAbbrevSt[iQuarter];
             } else if (oField.digits == 4) {
@@ -816,11 +932,11 @@ DateFormat.prototype.oSymbols = {
             } else {
                 for (var i = 0; i < aQuartersVariants.length; i++) {
                     var aVariants = aQuartersVariants[i];
-                    var oFound = oParseHelper.findEntry(sValue, aVariants);
+                    var oFound = oParseHelper.findEntry(sValue, aVariants, oFormat.oLocaleData.sCLDRLocaleId);
                     if (oFound.index !== -1) {
                         return {
                             quarter: oFound.index,
-                            length: oFound.value.length
+                            length: oFound.length
                         };
                     }
                 }
@@ -835,7 +951,7 @@ DateFormat.prototype.oSymbols = {
     },
     'F': {
         name: 'dayOfWeekInMonth',
-        format: function (oField, oDate, bUTC, oFormat) {
+        format: function (oField, oDate, oFormat) {
             return '';
         },
         parse: function () {
@@ -845,7 +961,7 @@ DateFormat.prototype.oSymbols = {
     'E': {
         name: 'dayNameInWeek',
         format: function (oField, oDate, bUTC, oFormat) {
-            var iDay = bUTC ? oDate.getUTCDay() : oDate.getDay();
+            var iDay = oDate.getUTCDay();
             if (oField.digits < 4) {
                 return oFormat.aDaysAbbrev[iDay];
             } else if (oField.digits == 4) {
@@ -869,11 +985,11 @@ DateFormat.prototype.oSymbols = {
             ];
             for (var i = 0; i < aDaysVariants.length; i++) {
                 var aVariants = aDaysVariants[i];
-                var oFound = oParseHelper.findEntry(sValue, aVariants);
+                var oFound = oParseHelper.findEntry(sValue, aVariants, oFormat.oLocaleData.sCLDRLocaleId);
                 if (oFound.index !== -1) {
                     return {
                         dayOfWeek: oFound.index,
-                        length: oFound.value.length
+                        length: oFound.length
                     };
                 }
             }
@@ -882,7 +998,7 @@ DateFormat.prototype.oSymbols = {
     'c': {
         name: 'dayNameInWeekStandalone',
         format: function (oField, oDate, bUTC, oFormat) {
-            var iDay = bUTC ? oDate.getUTCDay() : oDate.getDay();
+            var iDay = oDate.getUTCDay();
             if (oField.digits < 4) {
                 return oFormat.aDaysAbbrevSt[iDay];
             } else if (oField.digits == 4) {
@@ -906,11 +1022,11 @@ DateFormat.prototype.oSymbols = {
             ];
             for (var i = 0; i < aDaysVariants.length; i++) {
                 var aVariants = aDaysVariants[i];
-                var oFound = oParseHelper.findEntry(sValue, aVariants);
+                var oFound = oParseHelper.findEntry(sValue, aVariants, oFormat.oLocaleData.sCLDRLocaleId);
                 if (oFound.index !== -1) {
                     return {
                         day: oFound.index,
-                        length: oFound.value.length
+                        length: oFound.length
                     };
                 }
             }
@@ -919,7 +1035,7 @@ DateFormat.prototype.oSymbols = {
     'u': {
         name: 'dayNumberOfWeek',
         format: function (oField, oDate, bUTC, oFormat) {
-            var iDay = bUTC ? oDate.getUTCDay() : oDate.getDay();
+            var iDay = oDate.getUTCDay();
             return oFormat._adaptDayOfWeek(iDay);
         },
         parse: function (sValue, oPart, oFormat, oConfig) {
@@ -933,38 +1049,96 @@ DateFormat.prototype.oSymbols = {
     'a': {
         name: 'amPmMarker',
         format: function (oField, oDate, bUTC, oFormat) {
-            var iDayPeriod = bUTC ? oDate.getUTCDayPeriod() : oDate.getDayPeriod();
-            return oFormat.aDayPeriods[iDayPeriod];
+            var iDayPeriod = oDate.getUTCDayPeriod();
+            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, sTimezone) {
+            var rAMPM, bAMPMAlternativeCase, oEntry, i, aMatch, normalize, aVariants, aDayPeriodsVariants = [
+                    oFormat.aDayPeriodsWide,
+                    oFormat.aDayPeriodsAbbrev,
+                    oFormat.aDayPeriodsNarrow
+                ];
+            rAMPM = /[aApP](?:\.)?[\x20\xA0]?[mM](?:\.)?/;
+            aMatch = sValue.match(rAMPM);
+            bAMPMAlternativeCase = aMatch && aMatch.index === 0;
+            function normalize(sValue) {
+                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) {
+                    aVariants = aVariants.map(normalize);
+                }
+                oEntry = oParseHelper.findEntry(sValue, aVariants, oFormat.oLocaleData.sCLDRLocaleId);
+                if (oEntry.index !== -1) {
+                    return {
+                        pm: oEntry.index === 1,
+                        length: bAMPMAlternativeCase ? aMatch[0].length : oEntry.length
+                    };
+                }
+            }
+            return { valid: false };
+        }
+    },
+    'B': {
+        name: 'flexibleDayPeriod',
+        format: function (oField, oDate, bUTC, oFormat) {
+            var bContainsHour = oFormat.aFormatArray.some(function (oFormatElement) {
+                    return 'hHKk'.includes(oFormatElement.symbol);
+                }), sFlexibleDayPeriod = oFormat.oLocaleData.getFlexibleDayPeriodOfTime(oDate.getUTCHours(), oDate.getUTCMinutes());
+            if (bContainsHour) {
+                if (oField.digits <= 3) {
+                    return oFormat.oFlexibleDayPeriodsAbbrev[sFlexibleDayPeriod];
+                }
+                if (oField.digits === 4) {
+                    return oFormat.oFlexibleDayPeriodsWide[sFlexibleDayPeriod];
+                }
+                return oFormat.oFlexibleDayPeriodsNarrow[sFlexibleDayPeriod];
+            }
+            if (oField.digits <= 3) {
+                return oFormat.oFlexibleDayPeriodsAbbrevSt[sFlexibleDayPeriod];
+            }
+            if (oField.digits === 4) {
+                return oFormat.oFlexibleDayPeriodsWideSt[sFlexibleDayPeriod];
+            }
+            return oFormat.oFlexibleDayPeriodsNarrowSt[sFlexibleDayPeriod];
         },
         parse: function (sValue, oPart, oFormat, oConfig) {
-            var bPM;
-            var iLength;
-            var sAM = oFormat.aDayPeriods[0], sPM = oFormat.aDayPeriods[1];
-            var rAMPM = /[aApP](?:\.)?[mM](?:\.)?/;
-            var aMatch = sValue.match(rAMPM);
-            var bVariant = aMatch && aMatch.index === 0;
-            if (bVariant) {
-                sValue = aMatch[0].replace(/\./g, '').toLowerCase() + sValue.substring(aMatch[0].length);
-                sAM = sAM.replace(/\./g, '').toLowerCase();
-                sPM = sPM.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;
+            var i, oFound, oVariant, bContainsHour = oFormat.aFormatArray.some(function (oFormatElement) {
+                    return 'hHKk'.includes(oFormatElement.symbol);
+                }), aFlexibleDayPeriodVariants = [
+                    oFormat.oFlexibleDayPeriodsWide,
+                    oFormat.oFlexibleDayPeriodsAbbrev,
+                    oFormat.oFlexibleDayPeriodsNarrow
+                ];
+            if (bContainsHour) {
+                for (i = 0; i < aFlexibleDayPeriodVariants.length; i++) {
+                    oVariant = aFlexibleDayPeriodVariants[i];
+                    oFound = oParseHelper.findEntry(sValue, Object.values(oVariant), oFormat.oLocaleData.sCLDRLocaleId);
+                    if (oFound.index !== -1) {
+                        return {
+                            flexDayPeriod: Object.keys(oVariant)[oFound.index],
+                            length: oFound.length
+                        };
+                    }
+                }
             }
-            return {
-                pm: bPM,
-                length: iLength
-            };
+            return { valid: false };
         }
     },
     'H': {
         name: 'hour0_23',
-        format: function (oField, oDate, bUTC, oFormat) {
-            var iHours = bUTC ? oDate.getUTCHours() : oDate.getHours();
+        format: function (oField, oDate) {
+            var iHours = oDate.getUTCHours();
             return String(iHours).padStart(oField.digits, '0');
         },
         parse: function (sValue, oPart, oFormat, oConfig) {
@@ -984,8 +1158,8 @@ DateFormat.prototype.oSymbols = {
     },
     'k': {
         name: 'hour1_24',
-        format: function (oField, oDate, bUTC, oFormat) {
-            var iHours = bUTC ? oDate.getUTCHours() : oDate.getHours();
+        format: function (oField, oDate) {
+            var iHours = oDate.getUTCHours();
             var sHours = iHours === 0 ? '24' : String(iHours);
             return sHours.padStart(oField.digits, '0');
         },
@@ -1009,8 +1183,8 @@ DateFormat.prototype.oSymbols = {
     },
     'K': {
         name: 'hour0_11',
-        format: function (oField, oDate, bUTC, oFormat) {
-            var iHours = bUTC ? oDate.getUTCHours() : oDate.getHours();
+        format: function (oField, oDate) {
+            var iHours = oDate.getUTCHours();
             var sHours = String(iHours > 11 ? iHours - 12 : iHours);
             return sHours.padStart(oField.digits, '0');
         },
@@ -1031,8 +1205,8 @@ DateFormat.prototype.oSymbols = {
     },
     'h': {
         name: 'hour1_12',
-        format: function (oField, oDate, bUTC, oFormat) {
-            var iHours = bUTC ? oDate.getUTCHours() : oDate.getHours();
+        format: function (oField, oDate) {
+            var iHours = oDate.getUTCHours();
             var sHours;
             if (iHours > 12) {
                 sHours = String(iHours - 12);
@@ -1065,8 +1239,8 @@ DateFormat.prototype.oSymbols = {
     },
     'm': {
         name: 'minute',
-        format: function (oField, oDate, bUTC, oFormat) {
-            var iMinutes = bUTC ? oDate.getUTCMinutes() : oDate.getMinutes();
+        format: function (oField, oDate) {
+            var iMinutes = oDate.getUTCMinutes();
             return String(iMinutes).padStart(oField.digits, '0');
         },
         parse: function (sValue, oPart, oFormat, oConfig) {
@@ -1086,8 +1260,8 @@ DateFormat.prototype.oSymbols = {
     },
     's': {
         name: 'second',
-        format: function (oField, oDate, bUTC, oFormat) {
-            var iSeconds = bUTC ? oDate.getUTCSeconds() : oDate.getSeconds();
+        format: function (oField, oDate) {
+            var iSeconds = oDate.getUTCSeconds();
             return String(iSeconds).padStart(oField.digits, '0');
         },
         parse: function (sValue, oPart, oFormat, oConfig) {
@@ -1107,8 +1281,8 @@ DateFormat.prototype.oSymbols = {
     },
     'S': {
         name: 'fractionalsecond',
-        format: function (oField, oDate, bUTC, oFormat) {
-            var iMilliseconds = bUTC ? oDate.getUTCMilliseconds() : oDate.getMilliseconds();
+        format: function (oField, oDate) {
+            var iMilliseconds = oDate.getUTCMilliseconds();
             var sMilliseconds = String(iMilliseconds);
             var sFractionalseconds = sMilliseconds.padStart(3, '0');
             sFractionalseconds = sFractionalseconds.substr(0, oField.digits);
@@ -1129,17 +1303,18 @@ DateFormat.prototype.oSymbols = {
     },
     'z': {
         name: 'timezoneGeneral',
-        format: function (oField, oDate, bUTC, oFormat) {
+        format: function (oField, oDate, bUTC, oFormat, sTimezone) {
             if (oField.digits > 3 && oDate.getTimezoneLong && oDate.getTimezoneLong()) {
                 return oDate.getTimezoneLong();
             } else if (oDate.getTimezoneShort && oDate.getTimezoneShort()) {
                 return oDate.getTimezoneShort();
             }
+            var iTimezoneOffset = TimezoneUtil.calculateOffset(oDate, sTimezone);
             var sTimeZone = 'GMT';
-            var iTZOffset = Math.abs(oDate.getTimezoneOffset());
-            var bPositiveOffset = oDate.getTimezoneOffset() > 0;
+            var iTZOffset = Math.abs(iTimezoneOffset / 60);
+            var bPositiveOffset = iTimezoneOffset > 0;
             var iHourOffset = Math.floor(iTZOffset / 60);
-            var iMinuteOffset = iTZOffset % 60;
+            var iMinuteOffset = Math.floor(iTZOffset % 60);
             if (!bUTC && iTZOffset != 0) {
                 sTimeZone += bPositiveOffset ? '-' : '+';
                 sTimeZone += String(iHourOffset).padStart(2, '0');
@@ -1162,7 +1337,7 @@ DateFormat.prototype.oSymbols = {
                 iLength = 1;
                 iTZDiff = 0;
             } else {
-                return { error: 'cannot be parsed correcly by sap.ui.core.format.DateFormat: The given timezone is not supported!' };
+                return { error: 'cannot be parsed correctly by sap.ui.core.format.DateFormat: The given timezone is not supported!' };
             }
             if (sValue.charAt(0) !== 'Z') {
                 var oParsedTZ = oParseHelper.parseTZ(sValue.substr(iLength), true);
@@ -1177,11 +1352,12 @@ DateFormat.prototype.oSymbols = {
     },
     'Z': {
         name: 'timezoneRFC822',
-        format: function (oField, oDate, bUTC, oFormat) {
-            var iTZOffset = Math.abs(oDate.getTimezoneOffset());
-            var bPositiveOffset = oDate.getTimezoneOffset() > 0;
+        format: function (oField, oDate, bUTC, oFormat, sTimezone) {
+            var iTimezoneOffset = TimezoneUtil.calculateOffset(oDate, sTimezone);
+            var iTZOffset = Math.abs(iTimezoneOffset / 60);
+            var bPositiveOffset = iTimezoneOffset > 0;
             var iHourOffset = Math.floor(iTZOffset / 60);
-            var iMinuteOffset = iTZOffset % 60;
+            var iMinuteOffset = Math.floor(iTZOffset % 60);
             var sTimeZone = '';
             if (!bUTC) {
                 sTimeZone += bPositiveOffset ? '-' : '+';
@@ -1196,11 +1372,12 @@ DateFormat.prototype.oSymbols = {
     },
     'X': {
         name: 'timezoneISO8601',
-        format: function (oField, oDate, bUTC, oFormat) {
-            var iTZOffset = Math.abs(oDate.getTimezoneOffset());
-            var bPositiveOffset = oDate.getTimezoneOffset() > 0;
+        format: function (oField, oDate, bUTC, oFormat, sTimezone) {
+            var iTimezoneOffset = TimezoneUtil.calculateOffset(oDate, sTimezone);
+            var iTZOffset = Math.abs(iTimezoneOffset / 60);
+            var bPositiveOffset = iTimezoneOffset > 0;
             var iHourOffset = Math.floor(iTZOffset / 60);
-            var iMinuteOffset = iTZOffset % 60;
+            var iMinuteOffset = Math.floor(iTZOffset % 60);
             var sTimeZone = '';
             if (!bUTC && iTZOffset != 0) {
                 sTimeZone += bPositiveOffset ? '-' : '+';
@@ -1226,11 +1403,52 @@ DateFormat.prototype.oSymbols = {
                 return oParseHelper.parseTZ(sValue, oPart.digits === 3 || oPart.digits === 5);
             }
         }
+    },
+    'V': {
+        name: 'timezoneID',
+        format: function (oField, oDate, bUTC, oFormat, sTimezone) {
+            if (!bUTC && oField.digits === 2) {
+                return oFormat.oLocaleData.getTimezoneTranslations()[sTimezone] || sTimezone;
+            }
+            return '';
+        },
+        parse: function (sValue, oPart, oFormat, oConfig, sTimezone) {
+            var oTimezoneParsed = {
+                timezone: '',
+                length: 0
+            };
+            if (oPart.digits === 2) {
+                var mTimezoneTranslations = oFormat.oLocaleData.getTimezoneTranslations();
+                if (sValue === mTimezoneTranslations[sTimezone]) {
+                    return {
+                        timezone: sTimezone,
+                        length: sValue.length
+                    };
+                }
+                var aTimezoneTranslations = Object.values(mTimezoneTranslations);
+                var oTimezoneResult = oParseHelper.findEntry(sValue, aTimezoneTranslations, oFormat.oLocaleData.sCLDRLocaleId);
+                if (oTimezoneResult.index !== -1) {
+                    return {
+                        timezone: Object.keys(mTimezoneTranslations)[oTimezoneResult.index],
+                        length: oTimezoneResult.length
+                    };
+                }
+                var sCurrentValue = '';
+                for (var i = 0; i < sValue.length; i++) {
+                    sCurrentValue += sValue[i];
+                    if (TimezoneUtil.isValidTimezone(sCurrentValue)) {
+                        oTimezoneParsed.timezone = sCurrentValue;
+                        oTimezoneParsed.length = sCurrentValue.length;
+                    }
+                }
+            }
+            return oTimezoneParsed;
+        }
     }
 };
-DateFormat.prototype._format = function (oJSDate, bUTC) {
+DateFormat.prototype._format = function (oJSDate, bUTC, sTimezone) {
     if (this.oFormatOptions.relative) {
-        var sRes = this.formatRelative(oJSDate, bUTC, this.oFormatOptions.relativeRange);
+        var sRes = this.formatRelative(oJSDate, bUTC, this.oFormatOptions.relativeRange, sTimezone);
         if (sRes) {
             return sRes;
         }
@@ -1241,10 +1459,10 @@ DateFormat.prototype._format = function (oJSDate, bUTC) {
     for (var i = 0; i < this.aFormatArray.length; i++) {
         oPart = this.aFormatArray[i];
         sSymbol = oPart.symbol || '';
-        aBuffer.push(this.oSymbols[sSymbol].format(oPart, oDate, bUTC, this));
+        aBuffer.push(this.oSymbols[sSymbol].format(oPart, oDate, bUTC, this, sTimezone));
     }
     sResult = aBuffer.join('');
-    if (Core.getConfiguration().getOriginInfo()) {
+    if (Configuration.getOriginInfo()) {
         sResult = new String(sResult);
         sResult.originInfo = {
             source: 'Common Locale Data Repository',
@@ -1256,10 +1474,21 @@ DateFormat.prototype._format = function (oJSDate, bUTC) {
     return sResult;
 };
 DateFormat.prototype.format = function (vJSDate, bUTC) {
+    var sTimezone;
+    if (this.type === mDateFormatTypes.DATETIME_WITH_TIMEZONE) {
+        sTimezone = bUTC;
+        bUTC = false;
+        checkTimezoneParameterType(sTimezone);
+        if (sTimezone && !TimezoneUtil.isValidTimezone(sTimezone)) {
+            Log.error('The given timezone isn\'t valid.');
+            return '';
+        }
+    }
     var sCalendarType = this.oFormatOptions.calendarType, sResult;
     if (bUTC === undefined) {
         bUTC = this.oFormatOptions.UTC;
     }
+    sTimezone = sTimezone || Configuration.getTimezone();
     if (Array.isArray(vJSDate)) {
         if (!this.oFormatOptions.interval) {
             Log.error('Non-interval DateFormat can\'t format more than one date instance.');
@@ -1269,27 +1498,30 @@ DateFormat.prototype.format = function (vJSDate, bUTC) {
             Log.error('Interval DateFormat can only format with 2 date instances but ' + vJSDate.length + ' is given.');
             return '';
         }
+        vJSDate = vJSDate.map(function (oJSDate) {
+            return convertToTimezone(oJSDate, sTimezone, bUTC);
+        });
         if (this.oFormatOptions.singleIntervalValue) {
             if (vJSDate[0] === null) {
                 Log.error('First date instance which is passed to the interval DateFormat shouldn\'t be null.');
                 return '';
             }
             if (vJSDate[1] === null) {
-                sResult = this._format(vJSDate[0], bUTC);
+                sResult = this._format(vJSDate[0], bUTC, sTimezone);
             }
         }
         if (sResult === undefined) {
-            var bValid = vJSDate.every(function (oJSDate) {
-                return oJSDate && !isNaN(oJSDate.getTime());
-            });
-            if (!bValid) {
+            if (!vJSDate.every(isValidDateObject)) {
                 Log.error('At least one date instance which is passed to the interval DateFormat isn\'t valid.');
                 return '';
             }
             sResult = this._formatInterval(vJSDate, bUTC);
         }
     } else {
-        if (!vJSDate || isNaN(vJSDate.getTime())) {
+        if (!isValidDateObject(vJSDate)) {
+            if (this.type === mDateFormatTypes.DATETIME_WITH_TIMEZONE && this.oFormatOptions.pattern.includes('VV')) {
+                return this.oLocaleData.getTimezoneTranslations()[sTimezone] || sTimezone;
+            }
             Log.error('The given date instance isn\'t valid.');
             return '';
         }
@@ -1297,7 +1529,8 @@ DateFormat.prototype.format = function (vJSDate, bUTC) {
             Log.error('Interval DateFormat expects an array with two dates for the first argument but only one date is given.');
             return '';
         }
-        sResult = this._format(vJSDate, bUTC);
+        vJSDate = convertToTimezone(vJSDate, sTimezone, bUTC);
+        sResult = this._format(vJSDate, bUTC, sTimezone);
     }
     if (sCalendarType == CalendarType.Japanese && this.oLocale.getLanguage() === 'ja') {
         sResult = sResult.replace(/(^|[^\d])1年/g, '$1元年');
@@ -1317,7 +1550,7 @@ DateFormat.prototype._formatInterval = function (aJSDates, bUTC) {
     var oDiffField = this._getGreatestDiffField([
         oFromDate,
         oToDate
-    ], bUTC);
+    ]);
     if (!oDiffField) {
         return this._format(aJSDates[0], bUTC);
     }
@@ -1350,10 +1583,10 @@ var mFieldToGroup = {
     Minutes: 'Minute',
     Seconds: 'Second'
 };
-DateFormat.prototype._getGreatestDiffField = function (aDates, bUTC) {
+DateFormat.prototype._getGreatestDiffField = function (aDates) {
     var bDiffFound = false, mDiff = {};
     this.aIntervalCompareFields.forEach(function (sField) {
-        var sGetterPrefix = 'get' + (bUTC ? 'UTC' : ''), sMethodName = sGetterPrefix + sField, sFieldGroup = mFieldToGroup[sField], vFromValue = aDates[0][sMethodName].apply(aDates[0]), vToValue = aDates[1][sMethodName].apply(aDates[1]);
+        var sGetterPrefix = 'getUTC', sMethodName = sGetterPrefix + sField, sFieldGroup = mFieldToGroup[sField], vFromValue = aDates[0][sMethodName].apply(aDates[0]), vToValue = aDates[1][sMethodName].apply(aDates[1]);
         if (!deepEqual(vFromValue, vToValue)) {
             bDiffFound = true;
             mDiff[sFieldGroup] = true;
@@ -1364,9 +1597,12 @@ DateFormat.prototype._getGreatestDiffField = function (aDates, bUTC) {
     }
     return null;
 };
-DateFormat.prototype._parse = function (sValue, aFormatArray, bUTC, bStrict) {
-    var iIndex = 0, oPart, sSubValue, oResult;
-    var oDateValue = { valid: true };
+DateFormat.prototype._parse = function (sValue, aFormatArray, bUTC, bStrict, sTimezone) {
+    var iIndex = 0, sFlexibleDayPeriod, oPart, bPM, sSubValue, oResult;
+    var oDateValue = {
+        valid: true,
+        lastTimezonePatternSymbol: ''
+    };
     var oParseConf = {
         formatArray: aFormatArray,
         dateValue: oDateValue,
@@ -1376,7 +1612,10 @@ DateFormat.prototype._parse = function (sValue, aFormatArray, bUTC, bStrict) {
         sSubValue = sValue.substr(iIndex);
         oPart = aFormatArray[i];
         oParseConf.index = i;
-        oResult = this.oSymbols[oPart.symbol || ''].parse(sSubValue, oPart, this, oParseConf) || {};
+        oResult = this.oSymbols[oPart.symbol || ''].parse(sSubValue, oPart, this, oParseConf, sTimezone) || {};
+        if (oResult.tzDiff !== undefined || oResult.timezone) {
+            oResult.lastTimezonePatternSymbol = oPart.symbol;
+        }
         oDateValue = extend(oDateValue, oResult);
         if (oResult.valid === false) {
             break;
@@ -1384,7 +1623,12 @@ DateFormat.prototype._parse = function (sValue, aFormatArray, bUTC, bStrict) {
         iIndex += oResult.length || 0;
     }
     oDateValue.index = iIndex;
-    if (oDateValue.pm) {
+    bPM = oDateValue.pm;
+    if (oDateValue.flexDayPeriod && oDateValue.hour * 60 + (oDateValue.minute || 0) < 720) {
+        sFlexibleDayPeriod = this.oLocaleData.getFlexibleDayPeriodOfTime(oDateValue.hour + 12, oDateValue.minute || 0);
+        bPM = oDateValue.flexDayPeriod === sFlexibleDayPeriod;
+    }
+    if (bPM) {
         oDateValue.hour += 12;
     }
     if (oDateValue.dayNumberOfWeek === undefined && oDateValue.dayOfWeek !== undefined) {
@@ -1396,7 +1640,7 @@ DateFormat.prototype._parse = function (sValue, aFormatArray, bUTC, bStrict) {
     }
     return oDateValue;
 };
-DateFormat.prototype._parseInterval = function (sValue, sCalendarType, bUTC, bStrict) {
+DateFormat.prototype._parseInterval = function (sValue, sCalendarType, bUTC, bStrict, sTimezone) {
     var aDateValues, iRepeat, oDateValue;
     this.intervalPatterns.some(function (sPattern) {
         var aFormatArray = this.parseCldrDatePattern(sPattern);
@@ -1408,7 +1652,7 @@ DateFormat.prototype._parseInterval = function (sValue, sCalendarType, bUTC, bSt
             }
         }
         if (iRepeat === undefined) {
-            oDateValue = this._parse(sValue, aFormatArray, bUTC, bStrict);
+            oDateValue = this._parse(sValue, aFormatArray, bUTC, bStrict, sTimezone);
             if (oDateValue.index === 0 || oDateValue.index < sValue.length) {
                 oDateValue.valid = false;
             }
@@ -1422,13 +1666,13 @@ DateFormat.prototype._parseInterval = function (sValue, sCalendarType, bUTC, bSt
             return true;
         } else {
             aDateValues = [];
-            oDateValue = this._parse(sValue, aFormatArray.slice(0, iRepeat), bUTC, bStrict);
+            oDateValue = this._parse(sValue, aFormatArray.slice(0, iRepeat), bUTC, bStrict, sTimezone);
             if (oDateValue.valid === false) {
                 return;
             }
             aDateValues.push(oDateValue);
             var iLength = oDateValue.index;
-            oDateValue = this._parse(sValue.substring(iLength), aFormatArray.slice(iRepeat), bUTC, bStrict);
+            oDateValue = this._parse(sValue.substring(iLength), aFormatArray.slice(iRepeat), bUTC, bStrict, sTimezone);
             if (oDateValue.index === 0 || oDateValue.index + iLength < sValue.length) {
                 oDateValue.valid = false;
             }
@@ -1441,65 +1685,62 @@ DateFormat.prototype._parseInterval = function (sValue, sCalendarType, bUTC, bSt
     }.bind(this));
     return aDateValues;
 };
-var fnCreateDate = function (oDateValue, sCalendarType, bUTC, bStrict) {
+function getCalendarWeekParameter(oFormatOptions) {
+    if (oFormatOptions.calendarWeekNumbering) {
+        return oFormatOptions.calendarWeekNumbering;
+    } else if (oFormatOptions.firstDayOfWeek !== undefined && oFormatOptions.minimalDaysInFirstWeek !== undefined) {
+        return {
+            firstDayOfWeek: oFormatOptions.firstDayOfWeek,
+            minimalDaysInFirstWeek: oFormatOptions.minimalDaysInFirstWeek
+        };
+    }
+    return undefined;
+}
+var convertToTimezone = function (oJSDate, sTimezone, bUTC) {
+    if (!bUTC && isValidDateObject(oJSDate)) {
+        return TimezoneUtil.convertToTimezone(oJSDate, sTimezone);
+    }
+    return oJSDate;
+};
+var fnCreateDate = function (oDateValue, sCalendarType, bUTC, bStrict, sTimezone, oFormatOptions, oLocale) {
+    if (!oDateValue.valid) {
+        return null;
+    }
     var oDate, iYear = typeof oDateValue.year === 'number' ? oDateValue.year : 1970;
-    if (oDateValue.valid) {
-        if (bUTC || oDateValue.tzDiff !== undefined) {
-            oDate = UniversalDate.getInstance(new Date(0), sCalendarType);
-            oDate.setUTCEra(oDateValue.era || UniversalDate.getCurrentEra(sCalendarType));
-            oDate.setUTCFullYear(iYear);
-            oDate.setUTCMonth(oDateValue.month || 0);
-            oDate.setUTCDate(oDateValue.day || 1);
-            oDate.setUTCHours(oDateValue.hour || 0);
-            oDate.setUTCMinutes(oDateValue.minute || 0);
-            oDate.setUTCSeconds(oDateValue.second || 0);
-            oDate.setUTCMilliseconds(oDateValue.millisecond || 0);
-            if (bStrict && (oDateValue.day || 1) !== oDate.getUTCDate()) {
-                oDateValue.valid = false;
-                oDate = undefined;
-            } else {
-                if (oDateValue.tzDiff) {
-                    oDate.setUTCMinutes((oDateValue.minute || 0) + oDateValue.tzDiff);
-                }
-                if (oDateValue.week !== undefined && (oDateValue.month === undefined || oDateValue.day === undefined)) {
-                    oDate.setUTCWeek({
-                        year: oDateValue.weekYear || oDateValue.year,
-                        week: oDateValue.week
-                    });
-                    if (oDateValue.dayNumberOfWeek !== undefined) {
-                        oDate.setUTCDate(oDate.getUTCDate() + oDateValue.dayNumberOfWeek - 1);
-                    }
-                }
-            }
-        } else {
-            oDate = UniversalDate.getInstance(new Date(1970, 0, 1, 0, 0, 0), sCalendarType);
-            oDate.setEra(oDateValue.era || UniversalDate.getCurrentEra(sCalendarType));
-            oDate.setFullYear(iYear);
-            oDate.setMonth(oDateValue.month || 0);
-            oDate.setDate(oDateValue.day || 1);
-            oDate.setHours(oDateValue.hour || 0);
-            oDate.setMinutes(oDateValue.minute || 0);
-            oDate.setSeconds(oDateValue.second || 0);
-            oDate.setMilliseconds(oDateValue.millisecond || 0);
-            if (bStrict && (oDateValue.day || 1) !== oDate.getDate()) {
-                oDateValue.valid = false;
-                oDate = undefined;
-            } else if (oDateValue.week !== undefined && (oDateValue.month === undefined || oDateValue.day === undefined)) {
-                oDate.setWeek({
-                    year: oDateValue.weekYear || oDateValue.year,
-                    week: oDateValue.week
-                });
-                if (oDateValue.dayNumberOfWeek !== undefined) {
-                    oDate.setDate(oDate.getDate() + oDateValue.dayNumberOfWeek - 1);
-                }
-            }
+    oDate = UniversalDate.getInstance(new Date(0), sCalendarType);
+    oDate.setUTCEra(oDateValue.era || UniversalDate.getCurrentEra(sCalendarType));
+    oDate.setUTCFullYear(iYear);
+    oDate.setUTCMonth(oDateValue.month || 0);
+    oDate.setUTCDate(oDateValue.day || 1);
+    oDate.setUTCHours(oDateValue.hour || 0);
+    oDate.setUTCMinutes(oDateValue.minute || 0);
+    oDate.setUTCSeconds(oDateValue.second || 0);
+    oDate.setUTCMilliseconds(oDateValue.millisecond || 0);
+    if (bStrict && (oDateValue.day || 1) !== oDate.getUTCDate()) {
+        return null;
+    }
+    if (oDateValue.week !== undefined && (oDateValue.month === undefined || oDateValue.day === undefined)) {
+        oDate.setUTCWeek({
+            year: oDateValue.weekYear || oDateValue.year,
+            week: oDateValue.week
+        }, oLocale, getCalendarWeekParameter(oFormatOptions));
+        if (oDateValue.dayNumberOfWeek !== undefined) {
+            oDate.setUTCDate(oDate.getUTCDate() + oDateValue.dayNumberOfWeek - 1);
+        }
+    }
+    oDate = oDate.getJSDate();
+    if (!bUTC && (oDateValue.lastTimezonePatternSymbol === 'V' && oDateValue.timezone || oDateValue.tzDiff === undefined)) {
+        if (oDateValue.timezone) {
+            sTimezone = oDateValue.timezone;
         }
-        if (oDateValue.valid) {
-            oDate = oDate.getJSDate();
-            return oDate;
+        if (sTimezone) {
+            oDateValue.tzDiff = TimezoneUtil.calculateOffset(oDate, sTimezone);
         }
     }
-    return null;
+    if (oDateValue.tzDiff) {
+        oDate.setUTCSeconds(oDate.getUTCSeconds() + oDateValue.tzDiff);
+    }
+    return oDate;
 };
 function mergeWithoutOverwrite(object1, object2) {
     if (object1 === object2) {
@@ -1522,13 +1763,33 @@ function isValidDateRange(oStartDate, oEndDate) {
     }
     return true;
 }
+function isValidDateObject(oDate) {
+    return oDate && typeof oDate.getTime === 'function' && !isNaN(oDate.getTime());
+}
 DateFormat.prototype.parse = function (sValue, bUTC, bStrict) {
+    var bShowDate = this.oFormatOptions.showDate === undefined || this.oFormatOptions.showDate;
+    var bShowTime = this.oFormatOptions.showTime === undefined || this.oFormatOptions.showTime;
+    if (this.type === mDateFormatTypes.DATETIME_WITH_TIMEZONE && (bShowDate && !bShowTime || !bShowDate && bShowTime)) {
+        throw new TypeError('The input can only be parsed back to date if both date and time are supplied.');
+    }
+    var sTimezone;
+    if (bUTC === undefined && this.type !== mDateFormatTypes.DATETIME_WITH_TIMEZONE) {
+        bUTC = this.oFormatOptions.UTC;
+    }
+    var bUTCInputParameter = bUTC;
+    if (this.type === mDateFormatTypes.DATETIME_WITH_TIMEZONE) {
+        sTimezone = bUTC;
+        bUTC = false;
+        checkTimezoneParameterType(sTimezone);
+        if (sTimezone && !TimezoneUtil.isValidTimezone(sTimezone)) {
+            Log.error('The given timezone isn\'t valid.');
+            return null;
+        }
+    }
     sValue = sValue == null ? '' : String(sValue).trim();
     var oDateValue;
     var sCalendarType = this.oFormatOptions.calendarType;
-    if (bUTC === undefined) {
-        bUTC = this.oFormatOptions.UTC;
-    }
+    sTimezone = sTimezone || Configuration.getTimezone();
     if (bStrict === undefined) {
         bStrict = this.oFormatOptions.strictParsing;
     }
@@ -1540,22 +1801,40 @@ DateFormat.prototype.parse = function (sValue, bUTC, bStrict) {
         if (oJSDate) {
             return oJSDate;
         }
-        oDateValue = this._parse(sValue, this.aFormatArray, bUTC, bStrict);
+        oDateValue = this._parse(sValue, this.aFormatArray, bUTC, bStrict, sTimezone);
         if (oDateValue.index === 0 || oDateValue.index < sValue.length) {
             oDateValue.valid = false;
         }
-        oJSDate = fnCreateDate(oDateValue, sCalendarType, bUTC, bStrict);
+        oJSDate = fnCreateDate(oDateValue, sCalendarType, bUTC, bStrict, sTimezone, this.oFormatOptions, this.oLocale);
         if (oJSDate) {
+            if (this.type === mDateFormatTypes.DATETIME_WITH_TIMEZONE) {
+                var bShowTimezone = this.oFormatOptions.showTimezone === undefined || this.oFormatOptions.showTimezone;
+                if (!bShowTimezone && bShowDate && bShowTime) {
+                    return [
+                        oJSDate,
+                        undefined
+                    ];
+                } else if (bShowTimezone && !bShowDate && !bShowTime) {
+                    return [
+                        undefined,
+                        oDateValue.timezone
+                    ];
+                }
+                return [
+                    oJSDate,
+                    oDateValue.timezone || undefined
+                ];
+            }
             return oJSDate;
         }
     } else {
-        var aDateValues = this._parseInterval(sValue, sCalendarType, bUTC, bStrict);
+        var aDateValues = this._parseInterval(sValue, sCalendarType, bUTC, bStrict, sTimezone);
         var oJSDate1, oJSDate2;
         if (aDateValues && aDateValues.length == 2) {
             var oDateValue1 = mergeWithoutOverwrite(aDateValues[0], aDateValues[1]);
             var oDateValue2 = mergeWithoutOverwrite(aDateValues[1], aDateValues[0]);
-            oJSDate1 = fnCreateDate(oDateValue1, sCalendarType, bUTC, bStrict);
-            oJSDate2 = fnCreateDate(oDateValue2, sCalendarType, bUTC, bStrict);
+            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) {
                 if (this.oFormatOptions.singleIntervalValue && oJSDate1.getTime() === oJSDate2.getTime()) {
                     return [
@@ -1581,8 +1860,11 @@ DateFormat.prototype.parse = function (sValue, bUTC, bStrict) {
     if (!this.bIsFallback) {
         var vDate;
         this.aFallbackFormats.every(function (oFallbackFormat) {
-            vDate = oFallbackFormat.parse(sValue, bUTC, bStrict);
+            vDate = oFallbackFormat.parse(sValue, bUTCInputParameter, bStrict);
             if (Array.isArray(vDate)) {
+                if (oFallbackFormat.type === mDateFormatTypes.DATETIME_WITH_TIMEZONE) {
+                    return false;
+                }
                 return !(vDate[0] && vDate[1]);
             } else {
                 return !vDate;
@@ -1731,23 +2013,20 @@ DateFormat.prototype.parseRelative = function (sValue, bUTC) {
         }
     }
 };
-DateFormat.prototype.formatRelative = function (oJSDate, bUTC, aRange) {
-    var oToday = new Date(), oDateUTC, sScale = this.oFormatOptions.relativeScale || 'day', iDiff, sPattern, iDiffSeconds;
+DateFormat.prototype.formatRelative = function (oJSDate, bUTC, aRange, sTimezone) {
+    var oToday = convertToTimezone(new Date(), sTimezone), oDateUTC, sScale = this.oFormatOptions.relativeScale || 'day', iDiff, sPattern, iDiffSeconds;
     iDiffSeconds = (oJSDate.getTime() - oToday.getTime()) / 1000;
     if (this.oFormatOptions.relativeScale == 'auto') {
         sScale = this._getScale(iDiffSeconds, this.aRelativeScales);
+        sScale = fixScaleForMonths(oJSDate, oToday, sScale, iDiffSeconds);
     }
     if (!aRange) {
         aRange = this._mRanges[sScale];
     }
     if (sScale == 'year' || sScale == 'month' || sScale == 'day') {
-        oToday = new Date(Date.UTC(oToday.getFullYear(), oToday.getMonth(), oToday.getDate()));
+        oToday = new Date(Date.UTC(oToday.getUTCFullYear(), oToday.getUTCMonth(), oToday.getUTCDate()));
         oDateUTC = new Date(0);
-        if (bUTC) {
-            oDateUTC.setUTCFullYear(oJSDate.getUTCFullYear(), oJSDate.getUTCMonth(), oJSDate.getUTCDate());
-        } else {
-            oDateUTC.setUTCFullYear(oJSDate.getFullYear(), oJSDate.getMonth(), oJSDate.getDate());
-        }
+        oDateUTC.setUTCFullYear(oJSDate.getUTCFullYear(), oJSDate.getUTCMonth(), oJSDate.getUTCDate());
         oJSDate = oDateUTC;
     }
     iDiff = this._getDifference(sScale, [
@@ -1815,6 +2094,21 @@ DateFormat.prototype._getScale = function (iDiffSeconds, aScales) {
     }
     return sScale;
 };
+function fixScaleForMonths(oJSDate, oToday, sScale, iDiffSeconds) {
+    var iMonthDiff = Math.abs(oJSDate.getUTCMonth() - oToday.getUTCMonth());
+    if (sScale === 'week' && iMonthDiff === 2) {
+        return 'month';
+    } else if (sScale === 'week' && iMonthDiff === 1) {
+        if (oJSDate.getUTCDate() === oToday.getUTCDate() || iDiffSeconds < 0 && oJSDate.getUTCDate() < oToday.getUTCDate() || iDiffSeconds > 0 && oJSDate.getUTCDate() > oToday.getUTCDate()) {
+            return 'month';
+        }
+    } else if (sScale === 'month' && iMonthDiff === 1) {
+        if (iDiffSeconds > 0 && oJSDate.getUTCDate() < oToday.getUTCDate() || iDiffSeconds < 0 && oJSDate.getUTCDate() > oToday.getUTCDate()) {
+            return 'week';
+        }
+    }
+    return sScale;
+}
 function cutDateFields(oDate, iStartIndex) {
     var aFields = [
             'FullYear',
@@ -1827,21 +2121,21 @@ function cutDateFields(oDate, iStartIndex) {
         ], sMethodName;
     var oDateCopy = new Date(oDate.getTime());
     for (var i = iStartIndex; i < aFields.length; i++) {
-        sMethodName = 'set' + aFields[iStartIndex];
+        sMethodName = 'setUTC' + aFields[iStartIndex];
         oDateCopy[sMethodName].apply(oDateCopy, [0]);
     }
     return oDateCopy;
 }
 var mRelativeDiffs = {
     year: function (oFromDate, oToDate) {
-        return oToDate.getFullYear() - oFromDate.getFullYear();
+        return oToDate.getUTCFullYear() - oFromDate.getUTCFullYear();
     },
     month: function (oFromDate, oToDate) {
-        return oToDate.getMonth() - oFromDate.getMonth() + this.year(oFromDate, oToDate) * 12;
+        return oToDate.getUTCMonth() - oFromDate.getUTCMonth() + this.year(oFromDate, oToDate) * 12;
     },
     week: function (oFromDate, oToDate, oFormat) {
-        var iFromDay = oFormat._adaptDayOfWeek(oFromDate.getDay());
-        var iToDay = oFormat._adaptDayOfWeek(oToDate.getDay());
+        var iFromDay = oFormat._adaptDayOfWeek(oFromDate.getUTCDay());
+        var iToDay = oFormat._adaptDayOfWeek(oToDate.getUTCDay());
         oFromDate = cutDateFields(oFromDate, 3);
         oToDate = cutDateFields(oToDate, 3);
         return (oToDate.getTime() - oFromDate.getTime() - (iToDay - iFromDay) * oFormat._mScales.day * 1000) / (oFormat._mScales.week * 1000);
@@ -1868,7 +2162,12 @@ var mRelativeDiffs = {
     }
 };
 DateFormat.prototype._adaptDayOfWeek = function (iDayOfWeek) {
-    var iFirstDayOfWeek = LocaleData.getInstance(Core.getConfiguration().getFormatSettings().getFormatLocale()).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) {
         iDayNumberOfWeek += 7;