@openui5/sap.ui.core 1.99.0 → 1.100.1

package/src/sap/ui/model/odata/type/Boolean.js

@@ -87,7 +87,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 *
 	 * @alias sap.ui.model.odata.type.Boolean
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Byte.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.Int
 	 *
 	 * @author SAP SE
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 *
 	 * @alias sap.ui.model.odata.type.Byte
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Currency.js

@@ -61,7 +61,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.type.Currency
 	 * @public
 	 * @since 1.63.0
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 */
 	var Currency = BaseCurrency.extend("sap.ui.model.odata.type.Currency", {
 		constructor : function (oFormatOptions, oConstraints) {

package/src/sap/ui/model/odata/type/Date.js

@@ -106,7 +106,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 *
 	 * @alias sap.ui.model.odata.type.Date
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/DateTime.js

@@ -59,7 +59,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.DateTimeBase
 	 *
 	 * @author SAP SE
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 *
 	 * @alias sap.ui.model.odata.type.DateTime
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/DateTimeBase.js

@@ -132,7 +132,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 * @public
 	 * @since 1.27.0
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 */
 	var DateTimeBase = ODataType.extend("sap.ui.model.odata.type.DateTimeBase", {
 			constructor : function (oFormatOptions, oConstraints) {

package/src/sap/ui/model/odata/type/DateTimeOffset.js

@@ -28,7 +28,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.DateTimeBase
 	 *
 	 * @author SAP SE
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 *
 	 * @alias sap.ui.model.odata.type.DateTimeOffset
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/DateTimeWithTimezone.js

@@ -7,16 +7,17 @@
 sap.ui.define([
 	"sap/ui/core/format/DateFormat",
 	"sap/ui/core/format/DateFormatTimezoneDisplay",
+	"sap/ui/model/_Helper",
 	"sap/ui/model/CompositeType",
 	"sap/ui/model/FormatException",
 	"sap/ui/model/ParseException"
-], function (DateFormat, DateFormatTimezoneDisplay, CompositeType, FormatException,
+], function (DateFormat, DateFormatTimezoneDisplay, _Helper, CompositeType, FormatException,
 		ParseException) {
 	"use strict";
 
 	var oDemoDateTime = new Date(Date.UTC(new Date().getFullYear(), 11, 31, 23, 59, 58)),
-		sObjectRequiresHide = "Type 'object' requires format option 'showTimezone' set to "
-			+ "sap.ui.core.format.DateFormatTimezoneDisplay.Hide";
+		sObjectNotOnly = "For type 'object', the format option 'showTimezone' must not be set to "
+			+ "sap.ui.core.format.DateFormatTimezoneDisplay.Only";
 
 	/*
 	 * Returns the formatter. Creates it lazily.
@@ -27,8 +28,11 @@ sap.ui.define([
 	 *   The formatter
 	 */
 	function getFormatter(oType) {
+		var oFormatOptions;
+
 		if (!oType.oFormat) {
-			oType.oFormat = DateFormat.getDateTimeWithTimezoneInstance(oType.oFormatOptions);
+			oFormatOptions = _Helper.extend({strictParsing : true}, oType.oFormatOptions);
+			oType.oFormat = DateFormat.getDateTimeWithTimezoneInstance(oFormatOptions);
 		}
 		return oType.oFormat;
 	}
@@ -38,8 +42,10 @@ sap.ui.define([
 	 *
 	 * @param {object} [oFormatOptions]
 	 *   Format options. For a list of all available options, see
-	 *   {@link sap.ui.core.format.DateFormat.getDateTimeWithTimezoneInstance DateFormat}.
-	 *   Format options are immutable, that is, they can only be set once on construction.
+	 *   {@link sap.ui.core.format.DateFormat.getDateTimeWithTimezoneInstance DateFormat}. The
+	 *   <code>strictParsing</code> format option is set to <code>true</code> by default and can be
+	 *   overwritten. Format options are immutable, that is, they can only be set once on
+	 *   construction.
 	 * @param {object} [oConstraints]
 	 *   Constraints are not supported
 	 * @throws {Error}
@@ -49,12 +55,15 @@ sap.ui.define([
 	 * @author SAP SE
 	 * @class This class represents the <code>DateTimeWithTimezone</code> composite type which has
 	 * the parts timestamp and time zone. The type formats the timestamp part using the time zone
-	 * part. For this, the timestamp part has to be provided in the UTC time zone.
+	 * part. For this, the timestamp part has to be provided in the UTC time zone. When using this
+	 * type with the {@link sap.ui.model.odata.v2.ODataModel}, you need to set the parameter
+	 * <code>useUndefinedIfUnresolved</code> for both parts.
 	 * @extends sap.ui.model.CompositeType
 	 * @public
+	 * @see {sap.ui.model.odata.v2.ODataModel#bindProperty}
 	 * @since 1.99.0
 	 * @experimental The behavior of this type may change in the future.
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 */
 	var DateTimeWithTimezone = CompositeType.extend("sap.ui.model.odata.type.DateTimeWithTimezone",
 		{
@@ -67,6 +76,7 @@ sap.ui.define([
 				this.oFormat = null;
 				this.bParseWithValues = true;
 				this.bUseInternalValues = true;
+				this.vEmptyTimezoneValue = null;
 
 				// must not overwrite setConstraints and setFormatOptions on prototype as they are
 				// called in SimpleType constructor
@@ -114,7 +124,8 @@ sap.ui.define([
 	 *   The formatted output value; <code>null</code>,
 	 *   <ul>
 	 *     <li>if <code>aValues</code> is not set, or</li>
-	 *     <li>if the time zone in <code>aValues</code> is not set, or</li>
+	 *     <li>if the time zone or timestamp in <code>aValues</code> is <code>undefined</code>, or
+	 *     </li>
 	 *     <li>if the timestamp in <code>aValues</code> is not set and the <code>showTimezone</code>
 	 *       format option is set to <code>sap.ui.core.format.DateFormatTimezoneDisplay.Hide</code>
 	 *     </li>
@@ -126,8 +137,8 @@ sap.ui.define([
 	 *     <li>a timestamp is given in <code>aValues</code> that is not an instance of
 	 *       <code>Date</code>,</li>
 	 *     <li>the <code>sTargetType</code> is "object" or an equivalent primitive type, and the
-	 *       <code>showTimezone</code> format option is not
-	 *       <code>sap.ui.core.format.DateFormatTimezoneDisplay.Hide</code></li>
+	 *       <code>showTimezone</code> format option is
+	 *       <code>sap.ui.core.format.DateFormatTimezoneDisplay.Only</code></li>
 	 *   </ul>
 	 * @public
 	 */
@@ -137,8 +148,8 @@ sap.ui.define([
 			sTimezone = aValues && aValues[1];
 
 		if (!aValues
-				|| !sTimezone // time zone is mandatory
-				|| oTimestamp === undefined // data is not yet available (OData V4)
+				|| sTimezone === undefined // data is not yet available
+				|| oTimestamp === undefined // data is not yet available
 				// if time zone is not shown falsy timestamps cannot be formatted -> return null
 				|| (!oTimestamp && sShowTimezone === DateFormatTimezoneDisplay.Hide)) {
 			return null;
@@ -151,8 +162,8 @@ sap.ui.define([
 
 		switch (this.getPrimitiveType(sTargetType)) {
 			case "object":
-				if (sShowTimezone !== DateFormatTimezoneDisplay.Hide) {
-					throw new FormatException(sObjectRequiresHide);
+				if (sShowTimezone === DateFormatTimezoneDisplay.Only) {
+					throw new FormatException(sObjectNotOnly);
 				}
 
 				return oTimestamp;
@@ -234,13 +245,10 @@ sap.ui.define([
 	 *   <ul>
 	 *     <li><code>sSourceType</code> is unsupported,</li>
 	 *     <li>the value is not parsable,</li>
-	 *     <li>the <code>showTimezone</code> format option is
-	 *       <code>sap.ui.core.format.DateFormatTimezoneDisplay.Only</code> but no value is given,
-	 *     </li>
 	 *     <li><code>aCurrentValues</code> is not given,</li>
 	 *     <li>the <code>sSourceType</code> is "object" or an equivalent primitive type, and the
-	 *       <code>showTimezone</code> format option is not
-	 *       <code>sap.ui.core.format.DateFormatTimezoneDisplay.Hide</code>,</li>
+	 *       <code>showTimezone</code> format option is
+	 *       <code>sap.ui.core.format.DateFormatTimezoneDisplay.Only</code>,</li>
 	 *     <li>the <code>sSourceType</code> is "object" or an equivalent primitive type, and the
 	 *       value is not an instance of <code>Date</code></li>
 	 *   </ul>
@@ -248,7 +256,7 @@ sap.ui.define([
 	 * @public
 	 */
 	DateTimeWithTimezone.prototype.parseValue = function (vValue, sSourceType, aCurrentValues) {
-		var sCurrentTimezone, aDateWithTimezone,
+		var aDateWithTimezone,
 			sShowTimezone = this.oFormatOptions.showTimezone;
 
 		if (!aCurrentValues) {
@@ -257,19 +265,14 @@ sap.ui.define([
 
 		switch (this.getPrimitiveType(sSourceType)) {
 			case "object":
-				if (sShowTimezone !== DateFormatTimezoneDisplay.Hide) {
-					throw new ParseException(sObjectRequiresHide);
+				if (sShowTimezone === DateFormatTimezoneDisplay.Only) {
+					throw new ParseException(sObjectNotOnly);
 				}
 
 				if (!vValue) {
 					return [null, /*unchanged*/undefined];
 				}
 
-				if (!aCurrentValues[1]) {
-					throw new ParseException(sap.ui.getCore().getLibraryResourceBundle()
-						.getText("EnterDateTimeTimezoneFirst"));
-				}
-
 				if (!(vValue instanceof Date)) {
 					throw new ParseException("Given value must be an instance of Date");
 				}
@@ -278,32 +281,16 @@ sap.ui.define([
 			case "string":
 				if (!vValue) {
 					if (sShowTimezone === DateFormatTimezoneDisplay.Only) {
-						throw new ParseException(this._getErrorMessage());
+						return [/*unchanged*/undefined, this.vEmptyTimezoneValue];
 					}
 
 					return [null, /*unchanged*/undefined];
 				}
 
-				if (!aCurrentValues[1] && sShowTimezone === DateFormatTimezoneDisplay.Hide) {
-					throw new ParseException(sap.ui.getCore().getLibraryResourceBundle()
-						.getText("EnterDateTimeTimezoneFirst"));
-				}
-
-				sCurrentTimezone = aCurrentValues[1]
-					|| sap.ui.getCore().getConfiguration().getTimezone();
-				aDateWithTimezone = getFormatter(this).parse(vValue, sCurrentTimezone);
+				aDateWithTimezone = getFormatter(this).parse(vValue, aCurrentValues[1]);
 				if (!aDateWithTimezone) {
 					throw new ParseException(this._getErrorMessage());
 				}
-				// if time zone has been defaulted because current value does not have a time zone
-				// then the default time zone has to be added to the result if the time zone part of
-				// the parsed value indicates that it has not been changed; this can happen only
-				// if showTimezone format option is 'Show' or not set; in case of 'Hide' a
-				// ParseException is thrown earlier; in case of 'Only' the time zone part is never
-				// undefined
-				if (!aCurrentValues[1] && aDateWithTimezone[1] === undefined) {
-					aDateWithTimezone[1] = sCurrentTimezone;
-				}
 
 				return aDateWithTimezone;
 			default:
@@ -312,6 +299,27 @@ sap.ui.define([
 		}
 	};
 
+	/**
+	 * Processes the types of the parts of this composite type. Sets the parse result for an
+	 * empty time zone input to the empty string in case the string type of the time zone part
+	 * requires this.
+	 *
+	 * @param {sap.ui.model.SimpleType[]} aPartTypes Types of the composite binding's parts
+	 *
+	 * @override sap.ui.model.CompositeType#processPartTypes
+	 * @protected
+	 * @since 1.100.0
+	 */
+	DateTimeWithTimezone.prototype.processPartTypes = function (aPartTypes) {
+		var oTimezoneType = aPartTypes[1];
+
+		if (oTimezoneType
+				&& oTimezoneType.isA("sap.ui.model.odata.type.String")
+				&& oTimezoneType.getFormatOptions().parseKeepsEmptyString === true) {
+			this.vEmptyTimezoneValue = "";
+		}
+	};
+
 	/**
 	 * Validates whether the given raw values meet the defined constraints. This method does nothing
 	 * as no constraints are supported.

package/src/sap/ui/model/odata/type/Decimal.js

@@ -201,7 +201,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 *
 	 * @alias sap.ui.model.odata.type.Decimal
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Double.js

@@ -95,7 +95,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 *
 	 * @alias sap.ui.model.odata.type.Double
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Guid.js

@@ -62,7 +62,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 *
 	 * @alias sap.ui.model.odata.type.Guid
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Int.js

@@ -80,7 +80,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 *
 	 * @abstract
 	 * @alias sap.ui.model.odata.type.Int

package/src/sap/ui/model/odata/type/Int16.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.Int
 	 *
 	 * @author SAP SE
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 *
 	 * @alias sap.ui.model.odata.type.Int16
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Int32.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.Int
 	 *
 	 * @author SAP SE
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 *
 	 * @alias sap.ui.model.odata.type.Int32
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Int64.js

@@ -137,7 +137,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 *
 	 * @alias sap.ui.model.odata.type.Int64
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/ODataType.js

@@ -115,7 +115,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.SimpleType
 	 *
 	 * @author SAP SE
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 *
 	 * @abstract
 	 * @alias sap.ui.model.odata.type.ODataType

package/src/sap/ui/model/odata/type/Raw.js

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 * @public
 	 * @since 1.37.0
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 */
 	var Raw = ODataType.extend("sap.ui.model.odata.type.Raw", {
 			constructor : function (oFormatOptions, oConstraints) {

package/src/sap/ui/model/odata/type/SByte.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.Int
 	 *
 	 * @author SAP SE
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 *
 	 * @alias sap.ui.model.odata.type.SByte
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Single.js

@@ -95,7 +95,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 *
 	 * @alias sap.ui.model.odata.type.Single
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Stream.js

@@ -60,7 +60,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 * @public
 	 * @since 1.51.0
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 */
 	var Stream = ODataType.extend("sap.ui.model.odata.type.Stream", {
 			constructor : function (oFormatOptions, oConstraints) {

package/src/sap/ui/model/odata/type/String.js

@@ -84,7 +84,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 *
 	 * @alias sap.ui.model.odata.type.String
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Time.js

@@ -154,7 +154,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 *
 	 * @alias sap.ui.model.odata.type.Time
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/TimeOfDay.js

@@ -110,7 +110,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 * @public
 	 * @since 1.37.0
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 */
 	var TimeOfDay = ODataType.extend("sap.ui.model.odata.type.TimeOfDay", {
 			constructor : function (oFormatOptions, oConstraints) {

package/src/sap/ui/model/odata/type/Unit.js

@@ -63,7 +63,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.type.Unit
 	 * @public
 	 * @since 1.63.0
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 */
 	var Unit = BaseUnit.extend("sap.ui.model.odata.type.Unit", {
 		constructor : function (oFormatOptions, oConstraints, aDynamicFormatOptionNames) {

package/src/sap/ui/model/odata/v2/Context.js

@@ -57,7 +57,7 @@ sap.ui.define([
 	 * @hideconstructor
 	 * @public
 	 * @since 1.93.0
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 */
 	var Context = BaseContext.extend("sap.ui.model.odata.v2.Context", {
 			constructor : function (oModel, sPath, sDeepPath, oCreatePromise, bInactive) {
@@ -191,7 +191,9 @@ sap.ui.define([
 	/**
 	 * Returns whether this context is inactive. An inactive context will only be sent to the
 	 * server after the first property update. From then on it behaves like any other created
-	 * context.
+	 * context. The result of this function can also be accessed via the
+	 * "@$ui5.context.isInactive" instance annotation at the entity, see
+	 * {@link sap.ui.model.odata.v2.ODataModel#getProperty} for details.
 	 *
 	 * @return {boolean} Whether this context is inactive
 	 *
@@ -233,7 +235,9 @@ sap.ui.define([
 	 * {@link sap.ui.model.odata.v2.ODataListBinding#create}, the method returns <code>true</code>
 	 * if the context is transient or <code>false</code> if the context is not transient. A
 	 * transient context represents an entity created on the client which has not been persisted in
-	 * the back end.
+	 * the back end. The result of this function can also be accessed via the
+	 * "@$ui5.context.isTransient" instance annotation at the entity, see
+	 * {@link sap.ui.model.odata.v2.ODataModel#getProperty} for details.
 	 *
 	 * @returns {boolean}
 	 *   <ul>

package/src/sap/ui/model/odata/v2/ODataAnnotations.js

@@ -35,7 +35,7 @@ sap.ui.define([
 	 * @class Annotation loader for OData V2 services
 	 *
 	 * @author SAP SE
-	 * @version 1.99.0
+	 * @version 1.100.1
 	 *
 	 * @public
 	 * @since 1.37.0