Stopwatch

在运行时测量时间的计时器。

计时器可以是正在运行或停止的。它测量计时器运行期间经过的时间。

计时器最初创建时,处于停止状态且未测量经过的时间。

可以使用 elapsedelapsedMillisecondselapsedMicrosecondselapsedTicks 以不同的格式访问经过时间。

通过调用 start 来启动计时器。

示例

final stopwatch = Stopwatch();
print(stopwatch.elapsedMilliseconds); // 0
print(stopwatch.isRunning); // false
stopwatch.start();
print(stopwatch.isRunning); // true

要停止或暂停计时器,请使用 stop。当只是临时暂停时,使用 start 继续运行。

stopwatch.stop();
print(stopwatch.isRunning); // false
Duration elapsed = stopwatch.elapsed;
await Future.delayed(const Duration(seconds: 1));
assert(stopwatch.elapsed == elapsed); // No measured time elapsed.
stopwatch.start(); // Continue measuring.

reset 方法将经过时间重置为零。无论计时器是否正在运行都可以调用它,且不会改变其运行状态。

// Do some work.
stopwatch.stop();
print(stopwatch.elapsedMilliseconds); // Likely > 0.
stopwatch.reset();
print(stopwatch.elapsedMilliseconds); // 0

构造函数

Stopwatch()
创建一个处于停止状态且经过计数为零的 Stopwatch

属性

elapsed Duration
elapsedTicks 计数器转换为 Duration
无设置器
elapsedMicroseconds int
elapsedTicks 计数器转换为微秒。
无设置器
elapsedMilliseconds int
elapsedTicks 计数器转换为毫秒。
无设置器
elapsedTicks int
计时器运行时,自调用 start 以来经过的时钟滴答数。
无设置器
frequency int
经过计数器的频率(Hz)。
无设置器
hashCode int
此对象的哈希码。
无设置器继承
isRunning bool
判断 Stopwatch 是否当前正在运行。
无设置器
runtimeType Type
对象运行时类型的表示。
无设置器继承

方法

noSuchMethod(Invocation invocation) → dynamic
当访问不存在的方法或属性时调用。
继承
reset() → void
elapsed 计数器重置为零。
start() → void
启动 Stopwatch
stop() → void
停止Stopwatch
toString() String
此对象的字符串表示形式。
继承

运算符

operator ==(Object other) bool
等于运算符。
继承