new Cesium.TimeIntervalCollection(intervals)
按开始时间排序的
TimeInterval实例的非重叠集合。
| Name | Type | Description |
|---|---|---|
intervals |
Array.<TimeInterval> | optional 要添加到集合中的区间数组。 |
成员变量
获取每当区间集合发生更改时引发的事件。
获取集合是否为空。
获取开始时间是否包含在集合中。
获取集合中是否包含停止时间。
获取集合中的区间数。
获取集合的开始时间。
获取集合的停止时间。
内置方法
从一个ISO 8601时间区间（开始/结束/持续时间）创建一个新实例。
| Name | Type | Description | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
Object |
对象，具有以下属性：
|
||||||||||||||||||||||||||||
result |
TimeIntervalCollection | optional 要用于结果的现有实例。 |
返回值：
修改后的结果参数或新实例（如果没有提供）。
从ISO 8601日期数组中创建一个新实例。
| Name | Type | Description | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
Object |
对象，具有以下属性：
|
||||||||||||||||||||||||||||
result |
TimeIntervalCollection | optional 要用于结果的现有实例。 |
返回值：
修改后的结果参数或新实例（如果没有提供）。
staticCesium.TimeIntervalCollection.fromIso8601DurationArray(options, result) → TimeIntervalCollection
从ISO 8601持续时间数组中创建一个新实例。
| Name | Type | Description | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
Object |
对象，具有以下属性：
|
||||||||||||||||||||||||||||||||||||
result |
TimeIntervalCollection | optional 要用于结果的现有实例。 |
返回值：
修改后的结果参数或新实例（如果没有提供）。
从JulianDate数组创建一个新实例。
| Name | Type | Description | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
Object |
对象，具有以下属性：
|
||||||||||||||||||||||||||||
result |
TimeIntervalCollection | optional 要用于结果的现有实例。 |
返回值：
修改后的结果参数或新实例（如果没有提供）。
addInterval(interval, dataComparer)
将区间添加到集合中，合并包含相同数据的区间，并根据需要分割不同数据的区间，以维护不重叠的集合。
新区间中的数据优先于集合中任何现有的区间。
| Name | Type | Description |
|---|---|---|
interval |
TimeInterval | 要添加的区间。 |
dataComparer |
TimeInterval~DataComparer | optional 一个比较两个区间的数据的函数。如果省略，则使用引用相等。 |
检查指定的日期是否在此集合中。
| Name | Type | Description |
|---|---|---|
julianDate |
JulianDate | 要检查的日期。 |
返回值：
如果集合包含指定的日期则为
true，否则false。
将此实例与提供的实例分量比较，如果相等，则返回
true，否则返回false。
| Name | Type | Description |
|---|---|---|
right |
TimeIntervalCollection | optional 要比较的集合实例。 |
dataComparer |
TimeInterval~DataComparer | optional 一个比较两个区间的数据的函数。如果省略，则使用引用相等。 |
返回值：
如果它们相等，则为
true，否则false。
查找并返回包含指定日期的时间区间的数据。
| Name | Type | Description |
|---|---|---|
date |
JulianDate | 要搜索的日期。 |
返回值：
包含指定日期的区间的数据，或
undefined（如果不存在这样的区间）。
返回集合中与指定参数匹配的第一个区间。
所有参数都是可选的，
undefined参数被视为不关心条件。
| Name | Type | Description | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
Object |
optional
对象，具有以下属性：
|
返回值：
集合中与指定参数匹配的第一个区间。
查找并返回包含指定日期的区间。
| Name | Type | Description |
|---|---|---|
date |
JulianDate | 要搜索的日期。 |
返回值：
包含指定日期的区间，如果不存在这样的区间则为
undefined。
获取指定索引处的区间。
| Name | Type | Description |
|---|---|---|
index |
Number | 要检索的区间的索引。 |
返回值：
指定索引处的区间，或者
undefined（如果不存在该索引的区间）。
查找并返回集合中包含指定日期的时间区间的索引。
| Name | Type | Description |
|---|---|---|
date |
JulianDate | 要搜索的日期。 |
返回值：
区间的索引包含的指定的日期，如果没有这样的区间存在，它返回一个负数，
即在日期之后开始的下一个区间的索引的按位补数，或者如果在指定日期之后没有区间，则按位补全集合的长度。
intersect(other, dataComparer, mergeCallback) → TimeIntervalCollection
创建此集合与提供的集合的交集的新实例。
| Name | Type | Description |
|---|---|---|
other |
TimeIntervalCollection | 要与之相交的集合。 |
dataComparer |
TimeInterval~DataComparer | optional 一个比较两个区间的数据的函数。如果省略，则使用引用相等。 |
mergeCallback |
TimeInterval~MergeCallback | optional 将两个区间的数据合并在一起的函数。如果省略，则使用左区间的数据。 |
返回值：
一个新的TimeIntervalCollection，它是这个集合和提供的集合的交集。
removeAll()
从集合中移除所有区间。
从这个区间集合中移除指定的区间，在指定的区间上创建一个空洞（hole）。
忽略输入区间的数据属性。
| Name | Type | Description |
|---|---|---|
interval |
TimeInterval | 要删除的区间。 |
返回值：
如果指定的间隔被移除，则为
true；如果集合中没有指定的区间部分，则为false。
