ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage properties / Various properties
  • Range selection
  • Changing a time period in a Calendar, Organizer or Scheduler control
  • Special cases
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
The StartDate property is used to determine and change the start date of the selected time period:
  • in a Calendar control.
  • WINDEVWindows in an Organizer control.
  • WINDEVWindows in a Scheduler control.
Example
// Retrieve the selected period (Calendar control)
NbDays is int
NbDays = DateDifference(CAL_Calendar1.StartDate, CAL_Calendar1.EndDate) + 1
Info("Selected time period: from " + ...
DateToString(CAL_Calendar1.StartDate) + ...
" to " + DateToString(CAL_Calendar1.EndDate) + ...
" which means " + NbDays + " days")
Syntax

Determining the start date of the time period Hide the details

<Start date> = <Control used>.StartDate
<Start date>: Character string or Date variable
  • Start date of the time period selected in the control.
    • In a Calendar control, this date is in "YYYYMMDD" format.
    • WINDEVWindows In an Organizer or Scheduler control, this date is in "YYYYMMDDHHmmSSCCC" format.
  • Date of the selected day if a day is selected,
  • Empty string ("") if no day is selected.
<Control used>: Control name
Name of the control used:
  • Calendar control.
  • WINDEVWindows Organizer control.
  • WINDEVWindows Scheduler control.

Changing the start date of the time period Hide the details

<Control used>.StartDate = <New date>
<Control used>: Control name
Name of the control used:
  • Calendar control,
  • WINDEVWindows Organizer control.
  • WINDEVWindows Scheduler control.
<New date>: Character string or Date variable
Start date of the time period to be selected in the control.
  • In a Calendar control, this date is in "YYYYMMDD" format.
  • WINDEVWindows In an Organizer or Scheduler control, this date is in "YYYYMMDDHHmmSSCCC" format.
Remarks

Range selection

To select a time period :
  • in a Calendar control, " Range selection" must be selected in the "Details" tab.
  • WINDEVWindows in an Organizer control, the option "Allow time range selection" must be selected in the "Details" tab.
  • WINDEVWindows in a Scheduler control, the option "Allow time range selection" must be selected in the "Details" tab.

Changing a time period in a Calendar, Organizer or Scheduler control

To change the start date of a selected time period, specify the start date (StartDate property) and the end date (EndDate property). When the start date is changed:
  • the end date is automatically deselected.
  • the end date has to be selected (programmatically or by clicking a control date).
To change the end date of a selected time period, simply use the EndDate property: the time period changes automatically.

Special cases

  • The end date of a time period can be identified and changed with the EndDate property.
  • The StartDate property returns the start date of the time period in chronological order. Therefore, if the end date was selected before the start date, the StartDate property returns the last selected date.
Minimum version required
  • Version 14
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 03/08/2023

Send a report | Local help