TimeIntervalCollection

new Cesium.TimeIntervalCollection(intervals)

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

Members

获取每当集合中的间隔发生更改时引发的事件。
获取集合是否为空。

readonly isStartIncluded : boolean

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

readonly isStopIncluded : boolean

获取停止时间是否包含在集合中。
获取集合中的间隔数量。
获取集合的开始时间。
获取集合的停止时间。

Methods

static Cesium.TimeIntervalCollection.fromIso8601(options, result)TimeIntervalCollection

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

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

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

从 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)

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

contains(julianDate)boolean

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

equals(right, dataComparer)boolean

按组件方式将此实例与所提供的实例进行比较, 如果相等则返回 true,否则返回 false
Name Type Description
right TimeIntervalCollection optional 右侧集合。
dataComparer TimeInterval.DataComparer optional 比较两个间隔数据的函数。如果省略,则使用引用相等性。
Returns:
如果相等则返回 true,否则返回 false

findDataForIntervalContainingDate(date)object

查找并返回包含指定日期的间隔的数据。
Name Type Description
date JulianDate 要搜索的日期。
Returns:
包含指定日期的间隔的数据,如果不存在此类间隔则返回 undefined
返回集合中匹配指定参数的第一个间隔。 所有参数都是可选的,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

查找并返回包含指定日期的间隔。
Name Type Description
date JulianDate 要搜索的日期。
Returns:
包含指定日期的间隔,如果不存在此类间隔则返回 undefined
获取指定索引处的间隔。
Name Type Description
index number 要检索的间隔的索引。
Returns:
指定索引处的间隔,如果该索引处不存在间隔则返回 undefined
查找并返回集合中包含指定日期的间隔的索引。
Name Type Description
date JulianDate 要搜索的日期。
Returns:
包含指定日期的间隔的索引,如果不存在此类间隔, 则返回一个负数,即下一个在日期之后开始的间隔的索引的按位补码, 如果没有间隔在指定日期之后开始,则返回集合长度的按位补码。

intersect(other, dataComparer, mergeCallback)TimeIntervalCollection

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

removeInterval(interval)boolean

从此时间隔集合中移除指定的间隔,在指定的间隔上创建一个空洞。 输入间隔的 data 属性被忽略。
Name Type Description
interval TimeInterval 要移除的间隔。
Returns:
如果间隔被移除则为 true,如果集合中没有该间隔的任何部分则为 false
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.