TimeIntervalCollection

new Cesium.TimeIntervalCollection(intervals)
engine/Source/Core/TimeIntervalCollection.js 24

一个不重叠的 TimeInterval 实例集合，按开始时间排序。
Name Type Description
intervals Array.<TimeInterval> optional 要添加到集合的区间数组。

Members

readonly changedEvent : Event
engine/Source/Core/TimeIntervalCollection.js 43

获取每当区间集合发生变化时触发的事件。

readonly isEmpty : boolean
engine/Source/Core/TimeIntervalCollection.js 121

获取集合是否为空。

readonly isStartIncluded : boolean
engine/Source/Core/TimeIntervalCollection.js 68

获取开始时间是否包含在集合中。

readonly isStopIncluded : boolean
engine/Source/Core/TimeIntervalCollection.js 95

获取结束时间是否包含在集合中。

readonly length : number
engine/Source/Core/TimeIntervalCollection.js 109

获取集合中的区间数量。

readonly start : JulianDate
engine/Source/Core/TimeIntervalCollection.js 55

获取集合的开始时间。

readonly stop : JulianDate
engine/Source/Core/TimeIntervalCollection.js 81

获取集合的结束时间。

Methods

static Cesium.TimeIntervalCollection.fromIso8601(options, result) → TimeIntervalCollection
engine/Source/Core/TimeIntervalCollection.js 1007

从 ISO 8601 时间区间（开始/结束/持续时间）创建一个新实例。
Name Type Description
options object 具有以下属性的对象：
Name Type Default Description
iso8601 string 一个 ISO 8601 区间。
isStartIncluded boolean true optional 如果开始时间包含在区间内，则为 true；否则为 false。
isStopIncluded boolean true optional 如果结束时间包含在区间内，则为 true；否则为 false。
leadingInterval boolean false optional 如果要添加一个从 Iso8601.MINIMUM_VALUE 到开始时间的区间，则为 true；否则为 false。
trailingInterval boolean false optional 如果要添加一个从结束时间到 Iso8601.MAXIMUM_VALUE 的区间，则为 true；否则为 false。
dataCallback function optional 一个返回数据的函数，该函数在每个区间被添加到集合之前被调用。如果未指定，则数据将是集合中的索引。
result TimeIntervalCollection optional 用于结果的现有实例。
Returns:
修改后的结果参数，或者如果未提供则返回一个新实例。

static Cesium.TimeIntervalCollection.fromIso8601DateArray(options, result) → TimeIntervalCollection
engine/Source/Core/TimeIntervalCollection.js 1065

从一个 ISO 8601 日期数组创建一个新实例。
Name Type Description
options object 具有以下属性的对象：
Name Type Default Description
iso8601Dates Array.<string> 一个 ISO 8601 日期的数组。
isStartIncluded boolean true optional 如果开始时间包含在区间内，则为 true；否则为 false。
isStopIncluded boolean true optional 如果结束时间包含在区间内，则为 true；否则为 false。
leadingInterval boolean false optional 如果要添加一个从 Iso8601.MINIMUM_VALUE 到开始时间的区间，则为 true；否则为 false。
trailingInterval boolean false optional 如果要添加一个从结束时间到 Iso8601.MAXIMUM_VALUE 的区间，则为 true；否则为 false。
dataCallback function optional 一个返回数据的函数，该函数在每个区间被添加到集合之前被调用。如果未指定，则数据将是集合中的索引。
result TimeIntervalCollection optional 用于结果的现有实例。
Returns:
修改后的结果参数，或者如果未提供则返回一个新实例。

static Cesium.TimeIntervalCollection.fromIso8601DurationArray(options, result) → TimeIntervalCollection
engine/Source/Core/TimeIntervalCollection.js 1106

从一个 ISO 8601 持续时间数组创建一个新实例。
Name Type Description
options object 具有以下属性的对象：
Name Type Default Description
epoch JulianDate 持续时间相对于的日期。
iso8601Durations string 一个 ISO 8601 持续时间的数组。
relativeToPrevious boolean false optional 如果持续时间相对于前一个日期，则为 true；如果始终相对于纪元，则为 false。
isStartIncluded boolean true optional 如果开始时间包含在区间内，则为 true；否则为 false。
isStopIncluded boolean true optional 如果结束时间包含在区间内，则为 true；否则为 false。
leadingInterval boolean false optional 如果要添加一个从 Iso8601.MINIMUM_VALUE 到开始时间的区间，则为 true；否则为 false。
trailingInterval boolean false optional 如果要添加一个从结束时间到 Iso8601.MAXIMUM_VALUE 的区间，则为 true；否则为 false。
dataCallback function optional 一个返回数据的函数，该函数在每个区间被添加到集合之前被调用。如果未指定，则数据将是集合中的索引。
result TimeIntervalCollection optional 用于结果的现有实例。
Returns:
修改后的结果参数，或者如果未提供则返回一个新实例。

static Cesium.TimeIntervalCollection.fromJulianDateArray(options, result) → TimeIntervalCollection
engine/Source/Core/TimeIntervalCollection.js 753

从 JulianDate 数组创建一个新实例。
Name Type Description
options object 具有以下属性的对象：
Name Type Default Description
julianDates Array.<JulianDate> 一组 ISO 8601 日期的数组。
isStartIncluded boolean true optional 如果开始时间包含在区间内，则为 true；否则为 false。
isStopIncluded boolean true optional 如果结束时间包含在区间内，则为 true；否则为 false。
leadingInterval boolean false optional 如果要添加一个从 Iso8601.MINIMUM_VALUE 到开始时间的区间，则为 true；否则为 false。
trailingInterval boolean false optional 如果要添加一个从结束时间到 Iso8601.MAXIMUM_VALUE 的区间，则为 true；否则为 false。
dataCallback function optional 一个返回数据的函数，该函数在每个区间被添加到集合之前被调用。如果未指定，则数据将是集合中的索引。
result TimeIntervalCollection optional 用于结果的现有实例。
Returns:
修改后的结果参数，或者如果未提供则返回一个新实例。

addInterval(interval, dataComparer)
engine/Source/Core/TimeIntervalCollection.js 316

将一个区间添加到集合中，合并包含相同数据的区间， 并在需要时拆分不同数据的区间，以保持一个不重叠的集合。 新区间中的数据优先于集合中任何现有区间的数据。
Name Type Description
interval TimeInterval 要添加的区间。
dataComparer TimeInterval.DataComparer optional 一个比较两个区间数据的函数。如果省略，则使用引用相等性。

contains(julianDate) → boolean
engine/Source/Core/TimeIntervalCollection.js 217

检查指定日期是否在此集合内。
Name Type Description
julianDate JulianDate 要检查的日期。
Returns:
如果集合包含指定日期，则为 true；否则为 false。

equals(right, dataComparer) → boolean
engine/Source/Core/TimeIntervalCollection.js 138

将此实例与提供的实例逐个比较，并返回 如果相等则为 true，否则为 false。
Name Type Description
right TimeIntervalCollection optional 右侧集合。
dataComparer TimeInterval.DataComparer optional 一个比较两个区间数据的函数。如果省略，则使用引用相等性。
Returns:
如果相等则为 true，否则为 false。

findDataForIntervalContainingDate(date) → object
engine/Source/Core/TimeIntervalCollection.js 204

查找并返回包含指定日期的区间的数据。
Name Type Description
date JulianDate 要搜索的日期。
Returns:
包含指定日期的区间的数据，如果没有这样的区间，则返回 undefined。

findInterval(options) → TimeInterval|undefined
engine/Source/Core/TimeIntervalCollection.js 284

返回集合中第一个匹配指定参数的区间。 所有参数都是可选的，undefined 参数被视为不关心条件。
Name Type Description
options object optional 具有以下属性的对象：
Name Type Description
start JulianDate optional 区间的开始时间。
stop JulianDate optional 区间的结束时间。
isStartIncluded boolean optional 如果 options.start 包含在区间内，则为 true；否则为 false。
isStopIncluded boolean optional 如果 options.stop 包含在区间内，则为 true；否则为 false。
Returns:
集合中第一个匹配指定参数的区间。

findIntervalContainingDate(date) → TimeInterval|undefined
engine/Source/Core/TimeIntervalCollection.js 192

查找并返回包含指定日期的区间。
Name Type Description
date JulianDate 要搜索的日期。
Returns:
包含指定日期的区间，如果没有这样的区间，则返回 undefined。

get(index) → TimeInterval|undefined
engine/Source/Core/TimeIntervalCollection.js 165

获取指定索引处的区间。
Name Type Description
index number 要检索的区间的索引。
Returns:
指定索引处的区间，如果该索引没有区间，则返回 undefined。

indexOf(date) → number
engine/Source/Core/TimeIntervalCollection.js 231

查找并返回包含指定日期的区间在集合中的索引。
Name Type Description
date JulianDate 要搜索的日期。
Returns:
包含指定日期的区间的索引，如果没有这样的区间， 返回一个负数，该负数是下一个在日期之后开始的区间索引的按位补码；如果没有区间在指定日期之后开始，则返回集合长度的按位补码。

intersect(other, dataComparer, mergeCallback) → TimeIntervalCollection
engine/Source/Core/TimeIntervalCollection.js 679

创建一个新实例，该实例是此集合与提供的集合的交集。
Name Type Description
other TimeIntervalCollection 要与之交集的集合。
dataComparer TimeInterval.DataComparer optional 一个比较两个区间数据的函数。如果省略，则使用引用相等性。
mergeCallback TimeInterval.MergeCallback optional 一个合并两个区间数据的函数。如果省略，将使用左侧区间的数据。
Returns:
一个新创建的 TimeIntervalCollection，该集合是此集合与提供的集合的交集。

removeAll()
engine/Source/Core/TimeIntervalCollection.js 179

从集合中移除所有区间。

removeInterval(interval) → boolean
engine/Source/Core/TimeIntervalCollection.js 517

从此区间集合中移除指定的区间，在指定区间上创建一个空洞。 输入区间的数据属性将被忽略。
Name Type Description
interval TimeInterval 要移除的区间。
Returns:
如果区间被移除，则返回 true；如果该区间没有部分在集合中，则返回 false。
需要帮助？获得答案的最快方法是来自社区和团队 Cesium Forum.
packages/engine
packages/widgets