持续时间、时间跨度,如27天、4小时、12分钟和3秒。

Duration表示从一个时间点到另一个时间点的时间差。 如果是一个较晚的时间点和一个较早的时间点,Duration可能是负数。

通过适当的参数,使用类唯一的构造函数创建Duration对象:

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

Duration是所有各个参数的总和。 这意味着,各个参数的值不受单位限制。 例如,minutes的值可以大于59。

assert(fastestMarathon.inMinutes == 123);

各个参数允许使用负值。

使用其中一个属性,例如inDays,获取指定单位Duration的整数值。 请注意,返回的值是向下取整(向下舍入)得到的。 例如,

Duration aLongWeekend = new Duration(hours:88);
assert(aLongWeekend.inDays == 3);

该类提供了计算和比较操作的集合,以及一组用于转换时间单位的、实用的const常量。

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

Implements

Constants

HOURS_PER_DAY int

24
MICROSECONDS_PER_DAY int

MICROSECONDS_PER_HOUR * HOURS_PER_DAY
MICROSECONDS_PER_HOUR int

MICROSECONDS_PER_MINUTE * MINUTES_PER_HOUR
MICROSECONDS_PER_MILLISECOND int

1000
MICROSECONDS_PER_MINUTE int

MICROSECONDS_PER_SECOND * SECONDS_PER_MINUTE
MICROSECONDS_PER_SECOND int

MICROSECONDS_PER_MILLISECOND * MILLISECONDS_PER_SECOND
MILLISECONDS_PER_DAY int

MILLISECONDS_PER_HOUR * HOURS_PER_DAY
MILLISECONDS_PER_HOUR int

MILLISECONDS_PER_MINUTE * MINUTES_PER_HOUR
MILLISECONDS_PER_MINUTE int

MILLISECONDS_PER_SECOND * SECONDS_PER_MINUTE
MILLISECONDS_PER_SECOND int

1000
MINUTES_PER_DAY int

MINUTES_PER_HOUR * HOURS_PER_DAY
MINUTES_PER_HOUR int

60
SECONDS_PER_DAY int

SECONDS_PER_HOUR * HOURS_PER_DAY
SECONDS_PER_HOUR int

SECONDS_PER_MINUTE * MINUTES_PER_HOUR
SECONDS_PER_MINUTE int

60
ZERO Duration

const Duration(seconds: 0)

Constructors

Duration({int days: 0, int hours: 0, int minutes: 0, int seconds: 0, int milliseconds: 0, int microseconds: 0})

创建一个Duration对象,该对象的值是各个参数部分的总和。

const

Properties

hashCode int

read-only
inDays int

返回this跨越的天数。

read-only
inHours int

返回this跨越的小时数。

read-only
inMicroseconds int

返回this跨越的微秒数。

read-only
inMilliseconds int

返回this跨越的毫秒数。

read-only
inMinutes int

返回this跨越的分钟数。

read-only
inSeconds int

返回this跨越的秒数。

read-only
isNegative bool

判断this是否是负数。

read-only
runtimeType Type

表示对象的运行时类型。

read-only, inherited

Operators

operator *(num factor) Duration

返回新的Duration对象,值为thisfactor相乘的结果。

operator +(Duration other) Duration

返回新的Duration对象,值为thisother相加的和。

operator -(Duration other) Duration

返回新的Duration对象,值为this减去other的时间差。

operator <(Duration other) bool

如果this小于other的值,返回true

operator <=(Duration other) bool

如果this小于或等于other的值,返回true

operator ==(other) bool

如果this的值和other的值相等(持续时间一样),返回true

operator >(Duration other) bool

如果this大于other的值,返回true

operator >=(Duration other) bool

如果this大于或等于other的值,返回true

operator unary-() Duration

返回一个新的Duration对象表示this的负值。

operator ~/(int quotient) Duration

返回新的Duration对象,值为thisquotient取整的结果。

Methods

abs() Duration

返回一个新的Duration对象表示this的绝对值。

compareTo(Duration other) int

将此Duration与other进行比较。

noSuchMethod(Invocation invocation) → dynamic

当一个不存在的函数或成员变量被访问时,该函数被调用。

inherited
toString() String

返回一个字符串来表示此Duration