DateSys (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Functions for managing dates and times

See also

DateSys (Function)

In french: DateSys

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

Remarks:

The system date corresponds to the date of the day 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

Finding out 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 year, MM to month, DD to day, HH to hour, MM to minutes, SS to seconds and CC to hundredths of a second (use CCC for milliseconds). In this case, only the date is taken into account.
New in version 24
a character string in YYYYMMDDHHMMSSCC format (YYYY corresponds to year, MM to month, DD to day, HH to hour, MM to minutes, SS to seconds and CC to hundredths of a second (use CCC for milliseconds). In this case, only the date is taken into account.
a character string in YYYYMMDDHHMMSSCC format (YYYY corresponds to year, MM to month, DD to day, HH to hour, MM to minutes, SS to seconds and CC to hundredths of a second (use CCC for milliseconds). 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, you must define the string format (with DateToString, Right, Left) or use the properties on the dates. The YYYYMMDD format was chosen because it allows you to check the chronology between two dates, while this would not be possible with a date in YYYYDDMM format or in YYMMDD format for example.
On all the current systems, the year of the system date can be included between 1980 and 2099.
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 (today's date defined for the current computer or on the browser computer).
In simulation mode, the date of the PC is used. At run time, 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 : wd250std.dll