DateSys (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Date and time management functions

See also

DateSys (Function)

In french: DateSys

Returns or modifies the system date (current date defined on the current computer).

Remarks:

The system date corresponds to the current date defined on the server.
This function is equivalent to Today.

Versions 15 and later

This function is now available for Android applications.

New in version 15

This function is now available for Android applications.

Versions 16 and later

This function is now available for Windows Phone applications.

New in version 16

This function is now available for Windows Phone applications.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Android widget mode.

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Android widget mode.

This function is now available in Windows Store apps mode.

This function is now available in Android widget mode.

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Versions 25 and later

This function is now available in iOS widget mode.

This function is now available for Apple Watch applications.

New in version 25

This function is now available in iOS widget mode.

This function is now available for Apple Watch applications.

This function is now available in iOS widget mode.

This function is now available for Apple Watch applications.

Example

Res = DateSys() // Res = "20011225"
Res = DateToString(DateSys()) // Res = "25/12/2001"
Year = Left(DateSys(), 4)
// Year returns the current year (2001 for example)

// Changes the system date and displays the new date
DateSys("20020101")
Info(DateSys())

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).

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).
Versions 24 and later
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.
New in version 24
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 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.
Versions 24 and later
a DateTime variable. In this case, only the date is taken into account.
New in version 24
a DateTime variable. In this case, only the date is taken into account.
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.
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).
In simulation mode, the date of the PC is used. At runtime, the date of the mobile device is used.

Related Examples:

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: wd270std.dll