ChronoValue (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Date and time management functions

Threads and parallel tasks

Date management constants

DateTimeLocalToTimeZone

DateTimeLocalToUTC

DateTimeTimeZoneToLocal

Functions for managing dates and times

IntegerToDate

IntegerToDay

IntegerToDayInAlpha

IntegerToMonthInAlpha

Managing dates and times

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.

Versions 24 and later

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

New in version 24

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

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

Versions 24 and later

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

New in version 24

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.

Versions 24 and later

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.

New in version 24

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.

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