@openui5/sap.f 1.145.0 → 1.146.0

package/src/sap/f/cards/BaseHeader.js

@@ -33,7 +33,7 @@ sap.ui.define([
 	/**
 	 * @const int The refresh interval for dataTimestamp in ms.
 	 */
-	const DATA_TIMESTAMP_REFRESH_INTERVAL = 60000;
+	const DATA_TIMESTAMP_REFRESH_INTERVAL = 15000;
 
 	const oResourceBundle = Library.getResourceBundleFor("sap.f");
 
@@ -55,7 +55,7 @@ sap.ui.define([
 	 * @abstract
 	 *
 	 * @author SAP SE
-	 * @version 1.145.0
+	 * @version 1.146.0
 	 *
 	 * @constructor
 	 * @public
@@ -75,13 +75,13 @@ sap.ui.define([
 				 *
 				 * Will be shown as a relative time like "5 minutes ago".
 				 *
-				 * @experimental Since 1.89 this feature is experimental and the API may change.
+				 * @ui5-experimental-since 1.89
 				 */
 				dataTimestamp: { type: "string", defaultValue: ""},
 
 				/**
 				 * Defines the status text visibility.
-				 * @experimental Since 1.116 this feature is experimental and the API may change.
+				 * @ui5-experimental-since 1.116
 				 */
 				statusVisible: { type: "boolean", defaultValue: true },
 
@@ -115,8 +115,7 @@ sap.ui.define([
 
 				/**
 				 * Defines the type of text wrapping to be used inside the header. This applies to title, subtitle and details texts of the header.
-				 * @public
-				 * @experimental Since 1.122 this feature is experimental and the API may change.
+				 * @ui5-experimental-since 1.122
 				 */
 				wrappingType : {type: "sap.m.WrappingType", group : "Appearance", defaultValue : WrappingType.Normal},
 
@@ -129,14 +128,16 @@ sap.ui.define([
 				/**
 				 * Defines the href which the header should open. If set - the header will act and render as a link.
 				 *
-				 * @experimental Since 1.122. Do not use this feature outside of sap.ui.integration.widgets.Card.
+				 * @ui5-experimental-since 1.122
+				 * @ui5-restricted sap.ui.integration.widgets.Card
 				 */
 				href: { type: "string" },
 
 				/**
 				 * Defines the target for the case when <code>href</code> is given.
 				 *
-				 * @experimental Since 1.122. Do not use this feature outside of sap.ui.integration.widgets.Card.
+				 * @ui5-experimental-since 1.122
+				 * @ui5-restricted sap.ui.integration.widgets.Card
 				 */
 				target: { type: "string" }
 			},
@@ -144,8 +145,7 @@ sap.ui.define([
 
 				/**
 				 * Info sections to be displayed in the header.
-				 * @experimental Since 1.136
-				 * @since 1.136
+				 * @ui5-experimental-since 1.136
 				 */
 				infoSection: {type: "sap.ui.core.Control", multiple: true, singularName: "infoSection"},
 
@@ -156,8 +156,7 @@ sap.ui.define([
 
 				/**
 				 * Defines the toolbar.
-				 * @experimental Since 1.86
-				 * @since 1.86
+				 * @ui5-experimental-since 1.86
 				 */
 				toolbar: { type: "sap.ui.core.Control", multiple: false },
 
@@ -168,8 +167,8 @@ sap.ui.define([
 
 				/**
 				 * Show as a banner in the header area. Use for example for system info and application shortcut.
-				 * @experimental Since 1.118. For usage only by Work Zone.
-				 * @since 1.118
+				 * @ui5-experimental-since 1.118
+				 * @ui5-restricted Work Zone
 				 */
 				bannerLines: { type: "sap.m.Text", group: "Appearance", multiple: true  }
 			},
@@ -407,29 +406,43 @@ sap.ui.define([
 	 */
 	BaseHeader.prototype._updateDataTimestamp = function () {
 		var oDataTimestamp = this._createDataTimestamp(),
-			sDataTimestamp = this.getDataTimestamp(),
-			oDateFormat,
-			oUniversalDate,
-			sFormattedText;
+			sDataTimestamp = this.getDataTimestamp();
 
 		if (!sDataTimestamp) {
 			oDataTimestamp.setText("");
 			return;
 		}
 
-		oDateFormat = DateFormat.getDateTimeInstance({relative: true});
-		oUniversalDate = new UniversalDate(sDataTimestamp);
-		sFormattedText = oDateFormat.format(oUniversalDate);
-
-		// no less than "1 minute ago" should be shown, "30 seconds ago" should not be shown
-		if (oUniversalDate.getTime() + 59000 > Date.now()) {
-			sFormattedText = oResourceBundle.getText("CARD_HEADER_DATETIMESTAMP_NOW");
-		}
+		const sFormattedText = this._formatDataTimestamp(sDataTimestamp);
 
 		oDataTimestamp.setText(sFormattedText);
 		oDataTimestamp.removeStyleClass("sapFCardDataTimestampUpdating");
 	};
 
+	/**
+	 * Formats the data timestamp to a relative time string.
+	 * @private
+	 * @param {string} sDataTimestamp The data timestamp in ISO 8601 format.
+	 * @returns {string} The formatted data timestamp.
+	 */
+	BaseHeader.prototype._formatDataTimestamp = function (sDataTimestamp) {
+		const oDateFormat = DateFormat.getDateTimeInstance({relative: true});
+		const oUniversalDate = new UniversalDate(sDataTimestamp);
+
+		const iDiffMs = Date.now() - oUniversalDate.getTime();
+		const iTotalSeconds = Math.floor(iDiffMs / 1000);
+
+		const iRoundedMinutes = Math.floor((iTotalSeconds - 44) / 60) + 1;
+
+		const oRoundedDate = new UniversalDate(Date.now() - iRoundedMinutes * 60000);
+
+		if (iTotalSeconds <= 44) {
+			return oResourceBundle.getText("CARD_HEADER_DATETIMESTAMP_NOW");
+		}
+
+		return oDateFormat.format(oRoundedDate);
+	};
+
 	/**
 	 * Adds listener to update the timestamp on interval.
 	 * @private

package/src/sap/f/cards/Header.js

@@ -53,7 +53,7 @@ sap.ui.define([
 	 * @implements sap.f.cards.IHeader
 	 *
 	 * @author SAP SE
-	 * @version 1.145.0
+	 * @version 1.146.0
 	 *
 	 * @constructor
 	 * @public
@@ -73,7 +73,7 @@ sap.ui.define([
 
 				/**
 				 * Limits the number of lines for the title.
-				 * @experimental since 1.101
+				 * @ui5-experimental-since 1.101
 				 */
 				titleMaxLines: { type: "int", defaultValue: 3 },
 
@@ -84,7 +84,7 @@ sap.ui.define([
 
 				/**
 				 * Limits the number of lines for the subtitle.
-				 * @experimental since 1.101
+				 * @ui5-experimental-since 1.101
 				 */
 				subtitleMaxLines: { type: "int", defaultValue: 2 },
 
@@ -111,28 +111,28 @@ sap.ui.define([
 				/**
 				 * Defines an alt text for the avatar or icon.
 				 *
-				 * @experimental Since 1.81 this feature is experimental and the API may change.
+				 * @ui5-experimental-since 1.81
 				 */
 				iconAlt: { type: "string", defaultValue: "" },
 
 				/**
 				 * Defines a background color for the avatar or icon.
 				 *
-				 * @experimental Since 1.83 this feature is experimental and the API may change.
+				 * @ui5-experimental-since 1.83
 				 */
 				iconBackgroundColor: { type: "sap.m.AvatarColor", defaultValue: AvatarColor.Transparent },
 
 				/**
 				 * Defines whether the card icon is visible.
 				 *
-				 * @experimental Since 1.83 this feature is experimental and the API may change.
+				 * @ui5-experimental-since 1.83
 				 */
 				iconVisible: { type: "boolean", defaultValue: true },
 
 				/**
 				 * Defines the size of the icon.
 				 *
-				 * @experimental Since 1.119 this feature is experimental and the API may change.
+				 * @ui5-experimental-since 1.119
 				 */
 				iconSize: { type: "sap.m.AvatarSize", defaultValue: AvatarSize.S },
 

package/src/sap/f/cards/NumericHeader.js

@@ -55,7 +55,7 @@ sap.ui.define([
 	 * @implements sap.f.cards.IHeader
 	 *
 	 * @author SAP SE
-	 * @version 1.145.0
+	 * @version 1.146.0
 	 *
 	 * @constructor
 	 * @public
@@ -75,7 +75,7 @@ sap.ui.define([
 
 				/**
 				 * Limits the number of lines for the title.
-				 * @experimental since 1.101
+				 * @ui5-experimental-since 1.101
 				 */
 				titleMaxLines: { type: "int", defaultValue: 3 },
 
@@ -86,7 +86,7 @@ sap.ui.define([
 
 				/**
 				 * Limits the number of lines for the subtitle.
-				 * @experimental since 1.101
+				 * @ui5-experimental-since 1.101
 				 */
 				subtitleMaxLines: { type: "int", defaultValue: 2 },
 
@@ -97,53 +97,53 @@ sap.ui.define([
 
 				/**
 				 * Defines the shape of the icon.
-				 * @experimental Since 1.118. For usage only by Work Zone.
-				 * @since 1.118
+				 * @ui5-experimental-since 1.118
+				 * @ui5-restricted Work Zone
 				 */
 				iconDisplayShape: { type: "sap.m.AvatarShape", defaultValue: AvatarShape.Circle },
 
 				/**
 				 * Defines the icon source.
-				 * @experimental Since 1.118. For usage only by Work Zone.
-				 * @since 1.118
+				 * @ui5-experimental-since 1.118
+				 * @ui5-restricted Work Zone
 				 */
 				iconSrc: { type: "sap.ui.core.URI", defaultValue: "" },
 
 				/**
 				 * Defines the initials of the icon.
-				 * @experimental Since 1.118. For usage only by Work Zone.
-				 * @since 1.118
+				 * @ui5-experimental-since 1.118
+				 * @ui5-restricted Work Zone
 				 */
 				iconInitials: { type: "string", defaultValue: "" },
 
 				/**
 				 * Defines an alt text for the avatar or icon.
 				 *
-				 * @experimental Since 1.118. For usage only by Work Zone.
-				 * @since 1.118
+				 * @ui5-experimental-since 1.118
+				 * @ui5-restricted Work Zone
 				 */
 				iconAlt: { type: "string", defaultValue: "" },
 
 				/**
 				 * Defines a background color for the avatar or icon.
 				 *
-				 * @experimental Since 1.118. For usage only by Work Zone.
-				 * @since 1.118
+				 * @ui5-experimental-since 1.118
+				 * @ui5-restricted Work Zone
 				 */
 				iconBackgroundColor: { type: "sap.m.AvatarColor", defaultValue: AvatarColor.Transparent },
 
 				/**
 				 * Defines whether the card icon is visible.
 				 *
-				 * @experimental Since 1.118. For usage only by Work Zone.
-				 * @since 1.118
+				 * @ui5-experimental-since 1.118
+				 * @ui5-restricted Work Zone
 				 */
 				iconVisible: { type: "boolean", defaultValue: true },
 
 				/**
 				 * Defines the size of the icon.
 				 *
-				 * @experimental Since 1.119 this feature is experimental and the API may change.
+				 * @ui5-experimental-since 1.119
 				 */
 				iconSize: { type: "sap.m.AvatarSize", defaultValue: AvatarSize.S },
 
@@ -166,7 +166,7 @@ sap.ui.define([
 				number: { "type": "string", group : "Data" },
 
 				/**
-				 * The size of the of the main indicator. Possible values are "S" and "L".
+				 * The size of the main indicator. Possible values are "S" and "L".
 				 */
 				numberSize: { "type": "string", group : "Appearance", defaultValue: "L" },
 
@@ -190,8 +190,7 @@ sap.ui.define([
 
 				/**
 				 * The semantic color which represents the state of the main number indicator.
-				 * @experimental since 1.64
-				 * Disclaimer: this property is in a beta state - incompatible API changes may be done before its official public release. Use at your own discretion.
+				 * @ui5-experimental-since 1.64
 				 */
 				state: { "type": "sap.m.ValueColor", group: "Appearance", defaultValue : "Neutral" },
 
@@ -202,14 +201,14 @@ sap.ui.define([
 
 				/**
 				 * The semantic color which represents the state of the details text.
-				 * @experimental Since 1.118. For usage only by Work Zone.
-				 * @since 1.118
+				 * @ui5-experimental-since 1.118
+				 * @ui5-restricted Work Zone
 				 */
 				detailsState: { type : "sap.ui.core.ValueState", group: "Appearance", defaultValue: ValueState.None },
 
 				/**
 				 * Limits the number of lines for the details.
-				 * @experimental since 1.101
+				 * @ui5-experimental-since 1.101
 				 */
 				detailsMaxLines: { type: "int", defaultValue: 1 },
 
@@ -234,7 +233,7 @@ sap.ui.define([
 
 				/**
 				 * Micro Chart
-				 * @experimental since 1.124
+				 * @ui5-experimental-since 1.124
 				 */
 				microChart: {
 					type: "sap.ui.core.Control",

package/src/sap/f/cards/NumericIndicators.js

@@ -25,11 +25,10 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.145.0
+	 * @version 1.146.0
 	 *
 	 * @constructor
 	 * @private
-	 * @experimental 1.98
 	 * @since 1.98
 	 * @alias sap.f.cards.NumericIndicators
 	 */

package/src/sap/f/cards/NumericSideIndicator.js

@@ -28,7 +28,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.145.0
+	 * @version 1.146.0
 	 *
 	 * @constructor
 	 * @public
@@ -57,8 +57,7 @@ sap.ui.define([
 
 				/**
 				 * The semantic color which represents the state of the side indicator.
-				 * @experimental since 1.95
-				 * Disclaimer: this property is in a beta state - incompatible API changes may be done before its official public release. Use at your own discretion.
+				 * @ui5-experimental-since 1.95
 				 */
 				state: { "type": "sap.m.ValueColor", group: "Appearance", defaultValue : "None" },
 

package/src/sap/f/cards/loading/AnalyticalPlaceholder.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @extends sap.f.cards.loading.PlaceholderBase
 	 *
 	 * @author SAP SE
-	 * @version 1.145.0
+	 * @version 1.146.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/cards/loading/CalendarPlaceholder.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @extends sap.f.cards.loading.ListPlaceholder
 	 *
 	 * @author SAP SE
-	 * @version 1.145.0
+	 * @version 1.146.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/cards/loading/GenericPlaceholder.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @extends sap.f.cards.loading.PlaceholderBase
 	 *
 	 * @author SAP SE
-	 * @version 1.145.0
+	 * @version 1.146.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/cards/loading/ListPlaceholder.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @extends sap.f.cards.loading.PlaceholderBase
 	 *
 	 * @author SAP SE
-	 * @version 1.145.0
+	 * @version 1.146.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/cards/loading/ObjectPlaceholder.js

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * @extends sap.f.cards.loading.PlaceholderBase
 	 *
 	 * @author SAP SE
-	 * @version 1.145.0
+	 * @version 1.146.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/cards/loading/PlaceholderBase.js

@@ -22,7 +22,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.145.0
+	 * @version 1.146.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/cards/loading/TablePlaceholder.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @extends sap.f.cards.loading.PlaceholderBase
 	 *
 	 * @author SAP SE
-	 * @version 1.145.0
+	 * @version 1.146.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/cards/loading/TimelinePlaceholder.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @extends sap.f.cards.loading.PlaceholderBase
 	 *
 	 * @author SAP SE
-	 * @version 1.145.0
+	 * @version 1.146.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/changeHandler/MoveDynamicPageTitleActions.js

@@ -16,7 +16,7 @@ sap.ui.define([
 		 *
 		 * @alias sap.f.changeHandler.MoveDynamicPageTitleActions
 		 * @author SAP SE
-		 * @version 1.145.0
+		 * @version 1.146.0
 		 */
 		var MoveActions = { };
 		var ACTION_AGGREGATION_NAME = "actions";

package/src/sap/f/delegate/GridContainerItemNavigation.js

@@ -25,7 +25,7 @@ sap.ui.define([
 	 *
 	 *
 	 * @author SAP SE
-	 * @version 1.145.0
+	 * @version 1.146.0
 	 *
 	 * @extends sap.f.delegate.GridItemNavigation
 	 *

package/src/sap/f/delegate/GridItemNavigation.js

@@ -34,7 +34,7 @@ sap.ui.define([
 	 *
 	 *
 	 * @author SAP SE
-	 * @version 1.145.0
+	 * @version 1.146.0
 	 *
 	 * @extends sap.ui.core.delegate.ItemNavigation
 	 *

package/src/sap/f/dnd/GridDragOver.js

@@ -18,7 +18,7 @@ sap.ui.define([
 	 * Handles dragging of a control over a given grid container.
 	 *
 	 * @author SAP SE
-	 * @version 1.145.0
+	 * @version 1.146.0
 	 *
 	 * @extends sap.ui.base.Object
 	 *

package/src/sap/f/dnd/GridDropInfo.js

@@ -37,7 +37,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.dnd.DropInfo
 	 *
 	 * @author SAP SE
-	 * @version 1.145.0
+	 * @version 1.146.0
 	 *
 	 * @public
 	 * @since 1.68