DateNavigator (SAP Library - Web Dynpro for ABAP)

DateNavigator

The DateNavigator UI element enables users to display and enter dates. Users can navigate in a calendar and choose a day, month, year, or range of dates.

You can use the Legend and the DateNavigatorMarking elements to add a legend for the description of selected data to the DateNavigator UI element. This enables you to provide the user with information on specific data that is assigned to a category. For example, events in the calendar can be highlighted in a different color and each event can be described with agenda, time, and location.

Caution

UI element DateNavigatorLegend is obsolete. Instead, use UI element Legend.

The following date formats are provided in the DateNavigator:

● Gregorian

● Islamic

● Japanese

Note

The earliest date that can be displayed is 01.01.1901, the latest 30.11.9999.

Examples of the Display

Gregorian Calendar

This graphic is explained in the accompanying text

Islamic Calendar

This graphic is explained in the accompanying text

Japanese Calendar

This graphic is explained in the accompanying text

Changing the Date Format

To change the date format, proceed as follows:

1. Call transaction SU3, or choose System à User Profile à Own Data.

2. Choose the Defaults tab and in the dropdown menu under Date Format select the format you want.

There are the following restrictions when you change the date format:

● In the Islamic calendar the numbers for selecting the week count are replaced with *.

● In the Islamic and Japanese calendars the months are displayed with a number, not with their names.

● The length of a year or month in the Gregorian calendar is different in the Islamic calendar. This means that time periods will be displayed differently. For example, month 08/2005 (time period from 1. August to 31. August 2005) corresponds to end of month 06/1426 and the start of month 07/1426 in the Islamic calendar.

Note

To enable the development of accessible applications, the accessibilityDescription property is checked during the syntax check if the tooltip property is not set.

The accessibilityDescription property applies to the entire DateNavigator and is read out by the screen readers if the DateNavigator itself is focused on. The tooltip is displayed for each day, except if this day has a marking and this contains a filled tooltip.

Runtime Class

CL_WD_DATE_NAVIGATOR

Properties in View Designer

Name	Type	Initial Value	Bindable
ID	STRING	(automatic)	No
accessibilityDescription	Translatable text		Yes
contextMenuBehaviour	WDUI_CONTEXT_MENU_BEHAVIOUR	inherit	No
contextMenuId	WDY_MD_UI_ELEMENT_REFERENCE		No
enabled	WDY_BOOLEAN	true	Yes
firstDayOfWeek	WDUI_DAY_OF_WEEK	auto	Yes
firstSelectedDate	D		Yes
lastSelectedDate	D		Yes
legendId	WDY_MD_UI_ELEMENT_REFERENCE		Yes
monthsPerColumn	I	1	Yes
monthsPerRow	I	3	Yes
selectionMode	WDUI_DATE_SELECTION_MODE	single	Yes
startsWith	D		Yes
tooltip	Translatable text		Yes
visible	WDUI_VISIBILITY	visible	Yes

Aggregations in the View Designer

Name	Cardinality	Type
Legend	0..1	DateNavigatorLegend
Selection	0..1	DateNavigatorMarking

Events in the View Designer

Name

Note

Other properties that can be inherited are defined in the associated higher-level classes. The associated UI elements are:

● UIElement

● ContextMenuProvider

● ViewElement

Dynamic Programming

For dynamic programming, the same properties, events, and aggregations as in the View Designer are available. Bear in mind the different spellings.

Dynamic Programming of Properties

View Designer Name	Runtime Name	Type
accessibilityDescription	ACCESSIBILITY_DESCR	WDY_MD_TRANSLATABLE_TEXT
contextMenuBehaviour	CONTEXT_MENU_BEHAVIOUR	WDUI_CONTEXT_MENU_BEHAVIOUR
contextMenuBehaviour: inherit	CL_WD_DATE_NAVIGATOR=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT
contextMenuBehaviour: provide	CL_WD_DATE_NAVIGATOR=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE
contextMenuBehaviour: suppress	CL_WD_DATE_NAVIGATOR=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS
contextMenuId	CONTEXT_MENU_ID	WDY_MD_UI_ELEMENT_REFERENCE
enabled	ENABLED	WDY_BOOLEAN
firstDayOfWeek	FIRST_DAY_OF_WEEK	WDUI_DAY_OF_WEEK
firstDayOfWeek: auto	CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-AUTO
firstDayOfWeek: friday	CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-FRIDAY
firstDayOfWeek: monday	CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-MONDAY
firstDayOfWeek: saturday	CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-SATURDAY
firstDayOfWeek: sunday	CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-SUNDAY
firstDayOfWeek: thursday	CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-THURSDAY
firstDayOfWeek: tuesday	CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-TUESDAY
firstDayOfWeek: wednesday	CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-WEDNESDAY
firstSelectedDate	FIRST_SELECTED_DATE	D
lastSelectedDate	LAST_SELECTED_DATE	D
legendId	LEGEND_ID	WDY_MD_UI_ELEMENT_REFERENCE
monthsPerColumn	MONTHS_PER_COLUMN	I
monthsPerRow	MONTHS_PER_ROW	I
selectionMode	SELECTION_MODE	WDUI_DATE_SELECTION_MODE
selectionMode: none	CL_WD_DATE_NAVIGATOR=>E_SELECTION_MODE-NONE
selectionMode: range	CL_WD_DATE_NAVIGATOR=>E_SELECTION_MODE-RANGE
selectionMode: single	CL_WD_DATE_NAVIGATOR=>E_SELECTION_MODE-SINGLE
startsWith	STARTS_WITH	D
tooltip	TOOLTIP	WDY_MD_TRANSLATABLE_TEXT
visible	VISIBLE	WDUI_VISIBILITY
visible: none	CL_WD_DATE_NAVIGATOR=>E_VISIBLE-NONE
visible: visible	CL_WD_DATE_NAVIGATOR=>E_VISIBLE-VISIBLE

Dynamic Programming of Events

View Designer Name	Runtime Name
onDaySelect	ON_DAY_SELECT
onMonthSelect	ON_MONTH_SELECT
onStartDateChanged	ON_START_DATE_CHANGED
onWeekSelect	ON_WEEK_SELECT

Dynamic Programming of Aggregations

View Designer Name	Runtime Name	Cardinality
Legend	LEGEND	0..1
Selection	MARKING	0..1

Example

You can find examples of this interface element in the system in the Web Dynpro application WDR_TEST_UI_ELEMENTS, and in the component WDR_TEST_EVENTS in the View DateNavigator.