Show TOC Entering content frame

 Background documentationProperties of a Date Control and Time Control Locate the document in its SAP Library structure

The DateTime control is used to create both date and time controls on a tile. The value set in the Format property determines, whether you are creating a date control or a time control.

DateTime Property

Action

 

Anchor

Choose the anchor that you want to reference the data source.

BCOLFieldName
(appears only in List tiles)

Enter the name of the BDoc segment field.

This applies only if you want to display data from different business objects within a grid.

Note

The data source of the grid and the data source property must be BDoc segments of the same BDoc. You can associate only one business object to the grid. Therefore, if you want to display data from a different business object, you must enter a segment field name. This segment field should be part of the BDoc segment to which the business object of the grid is associated.

BO Attribute
(required)

View the name of the property to which this control is associated. You can also select a different property of a business object or business query.

Column Number
(appears only in List tiles)

Enter the position of the date or time control within the grid.

Example

If you enter 2, the date or time field appears in the second column in the grid.

Data Type
(related to Format)

Set the type of display format you require.

Date and time displays vary based on the regional settings on your system. The examples provided below are for the regional settings English (United States) and German (Standard).

When the Format property is set to Time, the data type provides the following options.

 

Setting

English (US)

German (Standard)

 

Time, TimeLong

02:04:15 PM      14

14:04:15      14:04

 

TimeShort

14:04

14:04

 

TimeMedium

02:04 PM

14:04

 

In the Format property if you have set the value to Date, select one of the following.

 

Setting

English (US)

German (Standard)

 

Date, DateShort

05/09/2005

09.05.2005

 

DateMedium

09-May-2005

09. Mai 2005

 

DateLong

Monday, May 9, 2005

Montag, 09. Mai 2005

 

Note

Time and TimeLong as well as Date and DateShort are identical. The date and time formats can be changed in the Microsoft Windows regional settings. For more information, see Microsoft’s documentation.

 

Format

Select Date if you want to create a date control.

Select Time if you want to create a time control.

 

IsGridColumn
(appears only in List tiles)

Determine if you want the control to be contained in the grid or outside the grid.

Select True if the control is to be a column within the grid.

Select False if the date or time control is to be displayed outside the grid.

Label
(required)

Enter a name to be displayed as the label of the date or time field.

 

Maximum Length

Enter a maximum number of characters that a user can add to this field. The number 0 (zero) sets the field size to unlimited.

 

Mode
(required)

Set the mode for the control.

The default setting is based on the attribute value of the business object property or business query property.

If set to …

Then …

Normal

The data is displayed at runtime and the user can select a different value in the date or time field.

Readonly

The data displayed in the date or time field is read-only.

Hidden

The date or time field will not be displayed.

Mandatory

The user must choose a value in the date or time field.

Note

The mode can change at runtime based on the mode set for the business object property or business query property. For example, you have set the mode to Normal. If the business object property is Readonly, the control changes the mode during runtime.

Name
(required)

Enter a name with the assigned namespace. This name is used to access this control in the code.

 

Offset

Enter the label width of the date or time control.

Note

This is not applicable when the control occurs in a grid.

 

Tab Order

Enter a number to determine the order in which the control is selected using the Tab key to navigate in a tile.

Top, Left, Bottom, Right
(required)

Set the coordinates based on the position of the control.

Note

You cannot change the value of the Bottom property. Its value is always equal to the value of the Top property plus a fixed number.

In a Detail tile, the control is placed in the absolute position.

In a List tile, the position of the control is based on the Tab Order property and not on these coordinates.

 

Use Long Text
(required)

Select True to display the long text of the combo engine associated with the BO Attribute displayed in the control’s input field.

Note

This is valid only if the:

·     Property specified in BO Attribute has a combo engine associated with it

·     Date or time control is not contained in a grid

Select False to display the short text assigned to the combo engine associated with the BO Attribute displayed in the control’s input field. This is valid for all properties specified in BO Attribute.

Select Both to display the short text and the long text in the control.

See also:

 

Defining a Date Control and Time Control

Leaving content frame