ChronoStart (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Functions for managing dates and times

Threads and parallel tasks

Related examples

See also

ChronoStart (Function)

In french: ChronoDébut

Starts a stopwatch to measure the duration of a process (in milliseconds) and resets a running stopwatch. The timing is stopped:

by ChronoEnd.
by ChronoPause.

If timing is stopped, it can be restarted by ChronoResume.

The value of the stopwatch can be read at any time:

with ChronoValue.
Versions 24 and later
via the Value property of the Chrono variable.
New in version 24
via the Value property of the Chrono variable.
via the Value property of the Chrono variable.

Versions 25 and later

This function is now available in browser code.

New in version 25

This function is now available in browser code.

Example

// Start the stopwatch
ChronoStart()
MyFunction()
// Stop the stopwatch
DurationMyFunction is Duration = ChronoEnd()
Info("The MyFunction() process lasted " + DurationMyFunction)

// Start the first stopwatch
ChronoStart(1)
// Start the second stopwatch
ChronoStart(2)
// Stop the first stopwatch
DurationChronoStart is Duration = ChronoEnd(1)
MyFunction()
// Stop the second stopwatch
DurationMyFunction is Duration = ChronoEnd(2)
Info("MyFunction() process lasted" + DurationMyFunction, ...
"The whole process lasted " + DurationChronoStart)

Versions 24 and later

MyChrono1 is Chrono
MyChrono2 is Chrono
// Start the first stopwatch
ChronoStart(MyChrono1)
// Start the second stopwatch
ChronoStart(MyChrono2)
// Stop the first stopwatch
DurationChronoStart is Duration = ChronoEnd(MyChrono1)
MyFunction()
// Stop the second stopwatch
DurationMyFunction is Duration = ChronoEnd(MyChrono2)
Info("The MyFunction() process lasted " + DurationMyFunction, ...
"The whole process lasted " + DurationChronoStart)

New in version 24

Syntax

Timing with a stopwatch number Hide the details

ChronoStart([<Stopwatch number>])

<Stopwatch number>: Optional integer

Identifier of stopwatch used.
If this parameter is not specified, its default value is set to 1.
If this number corresponds to a running stopwatch, it is reset to zero.

Versions 24 and later

Timing with a Chrono variable Hide the details

ChronoStart(<Stopwatch>)

<Stopwatch>: Chrono variable

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

New in version 24

Timing with a Chrono variable Hide the details

ChronoStart(<Stopwatch>)

<Stopwatch>: Chrono variable

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

Timing with a Chrono variable Hide the details

ChronoStart(<Stopwatch>)

<Stopwatch>: Chrono variable

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

Remarks

Error

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

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 is not called in the same thread (or in the same parallel task) as ChronoValue and ChronoEnd.

Related Examples:

Unit examples (WINDEV): The Chrono functions

[ + ] Using the ChronoXXX functions.
These functions are used to calculate the time passed between the start (ChronoStart) and the end (ChronoEnd).

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

Unit examples (WINDEV Mobile): The Chrono functions

[ + ] Using the WLanguage "Chrono" functions.
These functions are used to calculate the time passed between the start (ChronoStart) and the end (ChronoEnd).

Universal Apps (WINDEV Mobile): UWA Stopwatch

[ + ] This example explains how to create a stopwatch for a mobile device with WINDEV Mobile.
In this example, a timer is used to display the hands of the stopwatch and to display the time passed on a regular basis.

Business / UI classification : Neutral code

Component : wd260vm.dll