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:
  • 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)
WINDEVWindowsUser code (UMC)Stored procedures
// Changes the system date and displays the new date
DateSys("20020101")
Info(DateSys())
WINDEVWindowsLinuxUniversal Windows 10 AppJavaUser code (UMC)Stored 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).
WINDEVWindowsUser code (UMC)

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.
  • LinuxUniversal Windows 10 AppJava 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).
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