Duration 类

一段时间，例如 27 天，4 小时，12 分钟和 3 秒。

Duration 表示从一点时间到另一点时间的差值。如果这个差值是从后来的时间到较早的时间，则该时长可能是“负”的。

时长是独立于上下文的。例如，2 天的时长总是 48 小时，即使是在时区即将进行夏令时切换时将其添加到 DateTime 也会如此。（参见 DateTime.add）。

尽管名称相同，但 Duration 对象并没有实现 ISO 8601 规定的“时长”。特别是，时长对象不会跟踪个别提供的成员（例如“天数”或“小时”），而是只使用这些参数来计算对应的时间间隔长度。

要创建一个新的 Duration 对象，请使用该类的单个构造函数提供适当的参数

const fastestMarathon = Duration(hours: 2, minutes: 3, seconds: 2);

Duration 表示单个微秒数，它是构造函数中所有单个参数的总和。

属性可以以不同方式访问该单个数字。例如，inMinutes 会给出整个时长中的完整分钟数，这包括作为“小时”提供给构造函数的分钟数，并且可能大于 59。

const fastestMarathon = Duration(hours: 2, minutes: 3, seconds: 2);
print(fastestMarathon.inDays); // 0
print(fastestMarathon.inHours); // 2
print(fastestMarathon.inMinutes); // 123
print(fastestMarathon.inSeconds); // 7382
print(fastestMarathon.inMilliseconds); // 7382000

时长可以是负数，在这种情况下的所有从时长派生出的属性也都是非正的。

const overDayAgo = Duration(days: -1, hours: -10);
print(overDayAgo.inDays); // -1
print(overDayAgo.inHours); // -34
print(overDayAgo.inMinutes); // -2040

使用属性之一，例如 inDays，来获取 Duration 在指定时间单位中的整数值。请注意，返回的值是向下取整的。例如，

const aLongWeekend = Duration(hours: 88);
print(aLongWeekend.inDays); // 3

此类提供了一系列算术和比较运算符，以及一组有用的常量，可用于转换时间单位。

const firstHalf = Duration(minutes: 45); // 00:45:00.000000
const secondHalf = Duration(minutes: 45); // 00:45:00.000000
const overTime = Duration(minutes: 30); // 00:30:00.000000
final maxGameTime = firstHalf + secondHalf + overTime;
print(maxGameTime.inMinutes); // 120

// The duration of the firstHalf and secondHalf is the same, returns 0.
var result = firstHalf.compareTo(secondHalf);
print(result); // 0

// Duration of overTime is shorter than firstHalf, returns < 0.
result = overTime.compareTo(firstHalf);
print(result); // < 0

// Duration of secondHalf is longer than overTime, returns > 0.
result = secondHalf.compareTo(overTime);
print(result); // > 0

另请参阅

• DateTime 表示时间点。
• Stopwatch 用于测量时间间隔。