@openui5/sap.m 1.113.0 → 1.115.0

package/src/sap/m/DateTimeField.js

@@ -65,7 +65,7 @@ sap.ui.define([
 	 * @extends sap.m.InputBase
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.115.0
 	 *
 	 * @constructor
 	 * @public
@@ -88,7 +88,7 @@ sap.ui.define([
 				valueFormat: {type: "string", group: "Data", defaultValue: null},
 
 				/**
-				 * Holds a reference to a JavaScript Date Object. The <code>value</code> (string)
+				 * Holds a reference to a UI5Date or JavaScript Date object. The <code>value</code> (string)
 				 * property will be set according to it. Alternatively, if the <code>value</code>
 				 * and <code>valueFormat</code> pair properties are supplied instead,
 				 * the <code>dateValue</code> will be instantiated according to the parsed
@@ -100,7 +100,7 @@ sap.ui.define([
 				dateValue: {type: "object", group: "Data", defaultValue: null},
 
 				/**
-				 * Holds a reference to a JavaScript Date Object to define the initially focused
+				 * Holds a reference to a UI5Date or JavaScript Date object to define the initially focused
 				 * date/time when the picker popup is opened.
 				 *
 				 * <b>Notes:</b>
@@ -108,7 +108,7 @@ sap.ui.define([
 				 * <li>Setting this property does not change the <code>value</code> property.</li>
 				 * <li>Depending on the context this property is used in ({@link sap.m.TimePicker},
 				 * {@link sap.m.DatePicker} or {@link sap.m.DateTimePicker}), it takes into account only the time part, only
-				 * the date part or both parts of the JavaScript Date Object.</li>
+				 * the date part or both parts of the UI5Date or JavaScript Date object.</li>
 				 * </ul>
 				 * @since 1.54
 				 */
@@ -228,16 +228,16 @@ sap.ui.define([
 	/**
 	 * Setter for property <code>dateValue</code>.
 	 *
-	 * The date and time in DateTimeField as JavaScript Date object.
+	 * The date and time in DateTimeField as UI5Date or JavaScript Date object.
 	 *
-	 * @param {Date} oDate A JavaScript Date
+	 * @param {Date|module:sap/ui/core/date/UI5Date} oDate A date instance
 	 * @returns {this} Reference to <code>this</code> for method chaining
 	 * @public
 	 */
 	DateTimeField.prototype.setDateValue = function (oDate) {
 
 		if (!this._isValidDate(oDate)) {
-			throw new Error("Date must be a JavaScript date object; " + this);
+			throw new Error("Date must be a JavaScript or UI5Date date object; " + this);
 		}
 
 		if (deepEqual(this.getDateValue(), oDate)) {

package/src/sap/m/DateTimeInput.js

@@ -19,7 +19,8 @@ sap.ui.define([
 	'sap/ui/core/library',
 	'sap/ui/Device',
 	"./DateTimeInputRenderer",
-	"sap/ui/core/Configuration"
+	"sap/ui/core/Configuration",
+	"sap/ui/core/date/UI5Date"
 ],
 function(
 	jQuery,
@@ -35,7 +36,8 @@ function(
 	coreLibrary,
 	Device,
 	DateTimeInputRenderer,
-	Configuration
+	Configuration,
+	UI5Date
 ) {
 	"use strict";
 
@@ -64,7 +66,7 @@ function(
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.115.0
 	 *
 	 * @constructor
 	 * @public
@@ -361,7 +363,7 @@ function(
 
 		sValue = this.validateProperty("value", sValue);
 		if (sValue.toLowerCase() == "now") {
-			return this.setDateValue(new Date());
+			return this.setDateValue(UI5Date.getInstance());
 		}
 
 		if (sValue === this.getValue()) {

package/src/sap/m/DateTimePicker.js

@@ -99,19 +99,50 @@ sap.ui.define([
 	 *
 	 * On app level, there are two options to provide a date for the
 	 * <code>DateTimePicker</code> - as a string to the <code>value</code> property
-	 * or as a JavaScript Date object to the <code>dateValue</code> property (only one
+	 * or as a UI5Date or JavaScript Date object to the <code>dateValue</code> property (only one
 	 * of these properties should be used at a time):
 	 *
 	 * <ul><li>Use the <code>value</code> property if you want to bind the
 	 * <code>DateTimePicker</code> to a model using the
 	 * <code>sap.ui.model.type.DateTime</code></li>
+	 * @example <caption> binding the <code>value</code> property by using types </caption>
+	 * new sap.ui.model.json.JSONModel({date: sap.ui.core.date.UI5Date.getInstance(2022,10,10,12,10,10)});
+	 *
+	 * new sap.m.DateTimePicker({
+	 *     value: {
+	 *         type: "sap.ui.model.type.DateTime",
+	 *         path: "/date"
+	 *     }
+	 * });
+	 *
 	 * <li>Use the <code>value</code> property if the date is provided as a string from
 	 * the backend or inside the app (for example, as ABAP type DATS field)</li>
+	 * @example <caption> binding the <code>value</code> property by using types </caption>
+	 * new sap.ui.model.json.JSONModel({date:"2022-11-10-12-10-10"});
+	 *
+	 * new sap.m.DateTimePicker({
+	 *     value: {
+	 *         type: "sap.ui.model.type.DateTime",
+	 *         path: "/date",
+	 *         formatOptions: {
+	 *             source: {
+	 *                 pattern: "yyyy-MM-dd-HH-mm-ss"
+	 *             }
+	 *          }
+	 *     }
+	 * });
+	 *
+	 * <b>Note:</b> There are multiple binding type choices, such as:
+	 * sap.ui.model.type.Date
+	 * sap.ui.model.odata.type.DateTime
+	 * sap.ui.model.odata.type.DateTimeOffset
+	 * sap.ui.model.odata.type.DateTimeWithTimezone
+	 * See {@link sap.ui.model.type.Date}, {@link sap.ui.model.odata.type.DateTime}, {@link sap.ui.model.odata.type.DateTimeOffset} or {@link sap.ui.model.odata.type.DateTimeWithTimezone}
+	 *
 	 * <li>Use the <code>dateValue</code> property if the date is already provided as a
-	 * JavaScript Date object or you want to work with a JavaScript Date object.
+	 * UI5Date or JavaScript Date object or you want to work with a UI5Date or JavaScript Date object.
 	 * Use <code>dateValue</code> as a helper property to easily obtain the day, month, year,
-	 * hours, minutes and seconds of the chosen date and time. Although possible to bind it,
-	 * the recommendation is not to do it.
+	 * hours, minutes and seconds of the chosen date and time. Although it's possible to bind it, it's not recommended to do so.
 	 * When binding is needed, use <code>value</code> property instead</li></ul>
 	 *
 	 * <h3>Formatting</h3>
@@ -145,7 +176,7 @@ sap.ui.define([
 	 * mobile devices, it opens in full screen.
 	 *
 	 * @extends sap.m.DatePicker
-	 * @version 1.113.0
+	 * @version 1.115.0
 	 *
 	 * @constructor
 	 * @public
@@ -332,7 +363,7 @@ sap.ui.define([
 				});
 				oSwitcher.attachSelect(this._handleSelect, this);
 
-				this.setAggregation("_switcher", oSwitcher, true);
+				this.setAggregation("_switcher", oSwitcher);
 			}
 
 			if (Device.system.phone || jQuery('html').hasClass("sapUiMedia-Std-Phone") || this.getForcePhoneView()) {
@@ -579,9 +610,9 @@ sap.ui.define([
 	};
 
 	/**
-	 * Set minimum date that can be shown and selected in the <code>DateTimePicker</code>. This must be a JavaScript date object.
+	 * Set minimum date that can be shown and selected in the <code>DateTimePicker</code>. This must be a UI5Date or JavaScript Date object.
 	 *
-	 * @param {Date} oDate A JavaScript Date
+	 * @param {Date|module:sap/ui/core/date/UI5Date} oDate A date instance
 	 * @returns {this} Reference to <code>this</code> for method chaining
 	 * @public
 	 */
@@ -595,9 +626,9 @@ sap.ui.define([
 	};
 
 	/**
-	 * Set maximum date that can be shown and selected in the <code>DateTimePicker</code>. This must be a JavaScript date object.
+	 * Set maximum date that can be shown and selected in the <code>DateTimePicker</code>. This must be a UI5Date or JavaScript Date object.
 	 *
-	 * @param {Date} oDate A JavaScript Date
+	 * @param {Date|module:sap/ui/core/date/UI5Date} oDate A date instance
 	 * @returns {this} Reference to <code>this</code> for method chaining
 	 * @public
 	 */
@@ -1100,7 +1131,7 @@ sap.ui.define([
 	 * @name sap.m.DateTimePicker#getDateValue
 	 * @function
 	 * @public
-	 * @returns {Date} A JavaScript Date
+	 * @returns {Date|module:sap/ui/core/date/UI5Date} date instance
 	 * @since 1.102
 	 */
 

package/src/sap/m/Dialog.js

@@ -167,7 +167,7 @@ function(
 		*
 		* @implements sap.ui.core.PopupInterface
 		* @author SAP SE
-		* @version 1.113.0
+		* @version 1.115.0
 		*
 		* @constructor
 		* @public
@@ -640,7 +640,7 @@ function(
 
 			// title alignment
 			if (oHeader && oHeader.setTitleAlignment) {
-				oHeader.setProperty("titleAlignment", this.getTitleAlignment(), true);
+				oHeader.setTitleAlignment(this.getTitleAlignment());
 			}
 
 			if (oHeader && this._getTitles(oHeader).length === 0) {

package/src/sap/m/DisplayListItem.js

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * @extends sap.m.ListItemBase
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.115.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/DraftIndicator.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * @abstract
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.115.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/DynamicDate.js

@@ -38,7 +38,7 @@ sap.ui.define([
 		 * @extends sap.ui.model.SimpleType
 		 *
 		 * @author SAP SE
-		 * @version 1.113.0
+		 * @version 1.115.0
 		 *
 		 * @constructor
 		 * @public
@@ -54,7 +54,6 @@ sap.ui.define([
 		 * @param {int} [oConstraints.maximum] Greatest resulting date allowed for this type. Must be provided as a timestamps.
 		 * @since 1.92
 		 * @alias sap.m.DynamicDate
-		 * @experimental Since 1.92. This class is experimental and provides only limited functionality. Also the API might be changed in future.
 		 */
 		var DynamicDate = SimpleType.extend("sap.m.DynamicDate", /** @lends sap.m.DynamicDate.prototype  */ {
 
@@ -163,15 +162,15 @@ sap.ui.define([
 							case "minimum":
 								if (iTimestamp < iConstraintValue) {
 									aViolatedConstraints.push("minimum");
-									aMessages.push(oMBundle.getText(sErrorGenericTextKey, [new Date(iTimestamp).toDateString()]));
-									aMessages.push(oBundle.getText("Date.Minimum", [new Date(iConstraintValue).toDateString()]));
+									aMessages.push(oMBundle.getText(sErrorGenericTextKey, [UI5Date.getInstance(iTimestamp).toDateString()]));
+									aMessages.push(oBundle.getText("Date.Minimum", [UI5Date.getInstance(iConstraintValue).toDateString()]));
 								}
 								break;
 							case "maximum":
 								if (iTimestamp > iConstraintValue) {
 									aViolatedConstraints.push("maximum");
-									aMessages.push(oMBundle.getText(sErrorGenericTextKey, [new Date(iTimestamp).toDateString()]));
-									aMessages.push(oBundle.getText("Date.Maximum", [new Date(iConstraintValue).toDateString()]));
+									aMessages.push(oMBundle.getText(sErrorGenericTextKey, [UI5Date.getInstance(iTimestamp).toDateString()]));
+									aMessages.push(oBundle.getText("Date.Maximum", [UI5Date.getInstance(iConstraintValue).toDateString()]));
 								}
 								break;
 						}

package/src/sap/m/DynamicDateFormat.js

@@ -29,7 +29,6 @@ sap.ui.define([
 		 * @public
 		 * @hideconstructor
 		 * @alias sap.m.DynamicDateFormat
-		 * @experimental Since 1.92. This class is experimental and provides only limited functionality. Also the API might be changed in future.
 		 */
 		var DynamicDateFormat = function() {
 			// Do not use the constructor
@@ -227,17 +226,21 @@ sap.ui.define([
 			}
 
 			var aFormattedParams = aParams.map(function(param) {
-				if (param instanceof Date) {
+				var oParamValue = param;
+				if (param.getJSDate) {
+					oParamValue = param.getJSDate();
+				}
+				if (oParamValue instanceof Date) {
 					if (sKey === "DATETIMERANGE" || sKey === "FROMDATETIME" || sKey === "TODATETIME" || sKey === "DATETIME") {
-						return this._dateTimeFormatter.format(param);
+						return this._dateTimeFormatter.format(oParamValue);
 					}
-					return this._dateFormatter.format(param);
+					return this._dateFormatter.format(oParamValue);
 				}
 
-				if (typeof (param) === "number") {
-					return this._numberFormatter.format(param);
+				if (typeof (oParamValue) === "number") {
+					return this._numberFormatter.format(oParamValue);
 				} else {
-					return param.toString();
+					return oParamValue.toString();
 				}
 			}, this);
 

package/src/sap/m/DynamicDateOption.js

@@ -40,12 +40,11 @@ sap.ui.define([
 		 * @extends sap.ui.core.Element
 		 *
 		 * @author SAP SE
-		 * @version 1.113.0
+		 * @version 1.115.0
 		 *
 		 * @public
 		 * @since 1.92
 		 * @alias sap.m.DynamicDateOption
-		 * @experimental Since 1.92. This class is experimental and provides only limited functionality. Also the API might be changed in future.
 		 */
 		var DynamicDateOption = Element.extend("sap.m.DynamicDateOption", /** @lends sap.m.DynamicDateOption.prototype */ {
 			metadata: {
@@ -80,10 +79,10 @@ sap.ui.define([
 		};
 
 		/**
-		 * Defines the UI types of the option. They are used to create predefined
-		 * UI for the DynamicDateRange's value help dialog corresponding to this option.
+		 * Defines the UI types of the option. They are used to create predefined UI for
+		 * the DynamicDateRange's value help dialog corresponding to this option.
 		 * The types are DynamicDateValueHelpUIType instances. Their possible values are "date",
-		 * "daterange", "month", "int". The created UI consists of Calendar or Input controls.
+		 * "datetime", "daterange", "month", "int". The created UI consists of Calendar or Input controls.
 		 *
 		 * @param {sap.m.DynamicDateRange} oControl The control instance
 		 * @returns {sap.m.DynamicDateValueHelpUIType[]} An array with the option's UI types
@@ -95,7 +94,8 @@ sap.ui.define([
 
 		/**
 		 * Creates the option's value help UI. Mainly used for custom scenarios where
-		 * getValueHelpUITypes is not enough to define the UI.
+		 * getValueHelpUITypes is not enough to define the UI. In custom options, you can
+		 * create different controls that are used by the user to input data via interaction.
 		 *
 		 * @param {sap.m.DynamicDateRange} oControl The control instance
 		 * @param {function(sap.ui.base.Event)} fnControlsUpdated A callback invoked when any of the created controls updates its value
@@ -252,6 +252,12 @@ sap.ui.define([
 		 * Provides the order index of the option's group.
 		 * Used for grouping within the options list inside a DynamicDateRange's popup.
 		 * Standard options are arranged in 6 groups - from 1 to 6.
+		 * 1 - Single Dates
+		 * 2 - Date Ranges
+		 * 3 - Weeks
+		 * 4 - Months
+		 * 5 - Quarters
+		 * 6 - Years
 		 *
 		 * @returns {int} A group index
 		 * @public