TimeSys (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Functions for managing dates and times

See also

TimeSys (Function)

In french: HeureSys

Returns or modifies the system time (current time defined for the current computer).

Remark: This function is identical to Now.

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 = TimeSys() // Res = "15332105"
Res = TimeToString(TimeSys()) // Res = "15:33:21:05"
CurrentTime = Left(TimeSys(), 4) // CurrentTime = "1533"

// Display the current time in the CurrentTime control

// -- Initialization code of a window/page
// Call the "Clock" procedure every second
TimerSys("Clock", 100, 1)

// -- Clock procedure
PROCÉDURE Clock()
CurrentTime = TimeToString(TimeSys())

// Changes the system time and displays the new time
TimeSys("17280000")
Info(TimeSys())

TodaysDate is Date = DateSys()
EDT_EditDate = DateToDayInAlpha(TodaysDate) + " " + TodaysDate..Day + ...
" " + DateToMonthInAlpha(TodaysDate) + " at " + ...
TimeToString(TimeSys(), "HH:MM:SS")
// The EDT_EditDate control contains for example: Monday 20 August at 14:44:17

Syntax

Finding out the system time Hide the details

<Result> = TimeSys()

<Result>: Character string or Time variable

System time in HHMMSSCC format (HH corresponds to the hours, MM to the minutes, SS to the seconds and CC to the hundredths of a second).

Modifying the system time Hide the details

TimeSys(<New time>)

<New time>: Character string, Date or DateTime variable

New system time. This time can correspond to:
a character string in HHMMSSCC format (HH corresponds to hours, MM to minutes, SS to seconds and CC to hundredths of a second).
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. In this case, only the time 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. In this case, only the time 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. In this case, only the time is taken into account.
a Time variable.
Versions 24 and later
a DateTime variable. In this case, only the time is taken into account.
New in version 24
a DateTime variable. In this case, only the time is taken into account.
a DateTime variable. In this case, only the time is taken into account.

Remarks

Caution: To modify the system time, you must have the administrator rights on the current computer.
To get the time in a format other than HHMMSSCC, the string format can be defined with DateToString, Right, Left, etc.
The HHMMSSCC format was chosen because it allows you to compare two times to the hundredth of a second.
In Windows CE, the hundredths of a second are null in most cases (CC = 00).
In this version, TimeSys can only be used to return the system time (current time defined for the current computer or on the browser computer).
In simulation mode, the time used is the time on the PC where the simulation is run. In real use, the time 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