Stopwatch 类
在运行时测量时间的计时器。
计时器可以是正在运行或停止的。它测量计时器运行期间经过的时间。
计时器最初创建时,处于停止状态且未测量经过的时间。
可以使用 elapsed、elapsedMilliseconds、elapsedMicroseconds 或 elapsedTicks 以不同的格式访问经过时间。
通过调用 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
构造函数
属性
- 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 - 等于运算符。继承