ChronoValue (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Standard functions / Date and time management functions

Miscellaneous
Error
Threads and parallel tasks

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ChronoValue (Function)

In french: ChronoValeur

Indicates the time elapsed (in milliseconds) since the call to ChronoStart. The stopwatch is not stopped.

To stop the stopwatch, use ChronoEnd.

Remark: This function is equivalent to the Value property of Chrono variables.

New in version 28

Chrono variables are now available for Android applications. The syntax for handling Chrono variables also becomes available.

Chrono variables are now available in Android widget mode. The syntax for handling Chrono variables also becomes available.

Chrono variables are now available for Java applications. The syntax for handling Chrono variables also becomes available.

Example

DurationMyFunction1 is int
DurationMyFunction2 is int
TotalDuration is int
// Start the stopwatch
ChronoStart()
MyFunction1()
DurationMyFunction1 = ChronoEnd()
Info("The MyFunction1() process lasted " + DurationMyFunction1 + " milliseconds")

ChronoStart()
MyFunction2()
DurationMyFunction2 = ChronoEnd()
Info("The MyFunction2() process lasted " + DurationMyFunction2 + " milliseconds")

TotalDuration = DurationMyFunction1 + DurationMyFunction2
Info("The total process lasted " + TotalDuration + " milliseconds")

DurationMyFunction1 is int
TotalDuration is int
MyChrono is Chrono
// Start the stopwatch
ChronoStart(MyChrono)
MyFunction1()
DurationMyFunction1 = ChronoValue(MyChrono)
Trace("The MyFunction1() process lasted " + DurationMyFunction1 + " milliseconds")

MyFunction2()
TotalDuration = ChronoEnd(MyChrono)
Trace("The total process lasted (including the display) " + TotalDuration + " milliseconds")

Syntax

Indicating the value of a timing started with a stopwatch number Hide the details

<Result> = ChronoValue([<Stopwatch number>])

<Result>: Duration

Time elapsed (in milliseconds) since the last call to ChronoStart for the specified stopwatch number.
This parameter is an integer.

<Stopwatch number>: Optional integer

Identifier of stopwatch used. If this parameter is not specified, its default value is set to 1.

Indicating the value of a timing started with a Chrono variable Hide the details

<Result> = ChronoValue(<Stopwatch>)

<Result>: Duration

Time elapsed (in milliseconds) since the last call to ChronoStart for the specified stopwatch.

<Stopwatch>: Chrono variable

Name of the Chrono variable that corresponds to the stopwatch to use.

Remarks

Miscellaneous

After calling ChronoEnd, all the calls to ChronoValue will return the value of the stopwatch when ChronoEnd was called.

Error

A WLanguage error occurs ("The stopwatch is not started") if ChronoStart was not called before ChronoValue.

Threads and parallel tasks

Each thread (and each parallel task) includes its own stopwatches.

Two distinct threads (or two distinct parallel tasks) can perform separate timings by using the same stopwatch number.

The WLanguage error "The stopwatch is not started" will occur only if ChronoStart and ChronoValue are not called in the same thread.

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