ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Date and time functions
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
Returns or modifies the system date (current date defined on the current computer).
Remarks:
  • WEBDEV - Server code The system date corresponds to the current date defined on the server.
  • This function is equivalent to Today.
Example
Res = DateSys()   // Res = "20011225"
Res = DateToString(DateSys()) // Res = "25/12/2001"
Year = Left(DateSys(), 4)
// Year returns the current year (2001 for example)
WINDEVWEBDEV - Server codeReports and QueriesWindowsUser code (UMC)AjaxStored procedures
// Changes the system date and displays the new date
DateSys("20020101")
Info(DateSys())
WINDEVWEBDEV - Server codeReports and QueriesWindowsLinuxUniversal Windows 10 AppAndroidAndroid Widget JavaUser code (UMC)PHPAjaxStored procedures
TodaysDate is Date = DateSys()
EDT_Date = DateToDayInAlpha(TodaysDate) + " " + TodaysDate.Day + ...
" " + DateToMonthInAlpha(TodaysDate) + " at " + ...
TimeToString(TimeSys(), "HH:MM:SS")
// The EDT_Date control contains for example: Monday 13 August at 14:44:17
Syntax

Getting the system date Hide the details

<Result> = DateSys()
<Result>: Character string or Date variable
System date in YYYYMMDD format (YYYY corresponds to the year, MM to the month and DD to the day).
WINDEVWEBDEV - Server codeReports and QueriesWindowsUser code (UMC)Ajax

Modifying the system date Hide the details

DateSys(<New date>)
<New date>: Character string, Date or DateTime variable
New system date. This date can correspond to:
  • a character string in YYYYMMDD format (YYYY corresponds to the year, MM to the month and DD to the day).
  • a character string in YYYYMMDDHHmmSSCC format (YYYY corresponds to the year, MM to the month, DD to the day, HH to hours, mm to minutes, SS to seconds and CC to hundredths of a second (use CCC for thousandths of a second)). In this case, only the date is taken into account.
  • a Date variable.
  • a DateTime variable. In this case, only the date is taken into account.
Remarks
  • To get the system date in a format other than YYYYMMDD, the string must be formatted using the DateToString, Right, Left functions or the date properties. The YYYYMMDD format was chosen because it allows you to check the order of dates. This would not be possible with a date in YYYYDDMM or DDMMYYYY format, for example.
  • On all current systems, the year of the system date can be between 1920 and 2120.
  • Caution: To modify the system date, you must have the administrator rights on the current computer.
  • WEBDEV - Browser codeLinuxUniversal Windows 10 AppAndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystJavaPHP In this version, DateSys can only be used to return the system date (of the current computer or the computer where the browser is running).
  • AndroidAndroid Widget iPhone/iPad In simulation mode, the date of the PC is used. At runtime, the date of the mobile device is used.
Related Examples:
Calculations on durations Unit examples (WINDEV): Calculations on durations
[ + ] Calculations on dates and times with the WLanguage functions:
- Calculate the duration between two moments (dates and times)
- Calculate a sum of durations
- Calculate an average of durations
Business / UI classification: Neutral code
Component: wd290std.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
WinDev for a Windows application: beware of user privileges!
When trying to set the computer's clock to a certain date / time, the functions DateSys("20151231") or TimeSys("18:00:00") will not return an error code if the computer's clock is not set (mostly because of missing admin rights). If you wish to be able to act on a returned error then use the API SetSystemTime.
Jimbo
21 May 2015

Last update: 06/22/2023

Send a report | Local help