TimeIntervalCollection

new Cesium.TimeIntervalCollection ( intervals )

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

Members

获取每当间隔集合更改时引发的事件。

readonly isEmpty : Boolean

获取集合是否为空。

readonly isStartIncluded : Boolean

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

readonly isStopIncluded : Boolean

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

Methods

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

从 ISO 8601 时间间隔(开始/结束/持续时间)创建一个新实例。
Name Type Description
options Object 具有以下属性的对象:
姓名 类型 默认 描述
iso8601 细绳 ISO 8601 间隔。
isStartIncluded 布尔值 true 可选 true 开始时间包含在间隔中,则为 true,否则为 false 。
isStopIncluded 布尔值 true 可选 true 停止时间包含在间隔中,则为 true,否则为 false 。
leadingInterval 布尔值 false 可选 true 要添加从 Iso8601.MINIMUM_VALUE 到开始时间的间隔,则为 true,否则为 false 。
trailingInterval 布尔值 false 可选 true 要添加从停止时间到 Iso8601.MAXIMUM_VALUE 的间隔,则为 true,否则为 false 。
dataCallback 功能 可选 一个函数,它将返回在将每个间隔添加到集合之前调用的数据。如果未指定,数据将是集合中的索引。
result TimeIntervalCollection 可选 用于结果的现有实例。
Returns:
修改后的结果参数或新实例(如果没有提供)。

static Cesium.TimeIntervalCollection.fromIso8601DateArray (options, result ) → TimeIntervalCollection

从 ISO 8601 日期数组创建一个新实例。
Name Type Description
options Object 具有以下属性的对象:
姓名 类型 默认 描述
iso8601Dates 数组。<字符串> 一组 ISO 8601 日期。
isStartIncluded 布尔值 true 可选 true 开始时间包含在间隔中,则为 true,否则为 false 。
isStopIncluded 布尔值 true 可选 true 停止时间包含在间隔中,则为 true,否则为 false 。
leadingInterval 布尔值 false 可选 true 要添加从 Iso8601.MINIMUM_VALUE 到开始时间的间隔,则为 true,否则为 false 。
trailingInterval 布尔值 false 可选 true 要添加从停止时间到 Iso8601.MAXIMUM_VALUE 的间隔,则为 true,否则为 false 。
dataCallback 功能 可选 一个函数,它将返回在将每个间隔添加到集合之前调用的数据。如果未指定,数据将是集合中的索引。
result TimeIntervalCollection 可选 用于结果的现有实例。
Returns:
修改后的结果参数或新实例(如果没有提供)。

static Cesium.TimeIntervalCollection.fromIso8601DurationArray (options, result ) → TimeIntervalCollection

从 ISO 8601 持续时间数组创建一个新实例。
Name Type Description
options Object 具有以下属性的对象:
姓名 类型 默认 描述
epoch 朱利安日期 与持续时间相关的日期。
iso8601Durations 细绳 一组 ISO 8601 持续时间。
relativeToPrevious 布尔值 false 可选 true 持续时间相对于前一个日期,则为 false ,如果始终相对于纪元,则为 false。
isStartIncluded 布尔值 true 可选 true 开始时间包含在间隔中,则为 true,否则为 false 。
isStopIncluded 布尔值 true 可选 true 停止时间包含在间隔中,则为 true,否则为 false 。
leadingInterval 布尔值 false 可选 true 要添加从 Iso8601.MINIMUM_VALUE 到开始时间的间隔,则为 true,否则为 false 。
trailingInterval 布尔值 false 可选 true 要添加从停止时间到 Iso8601.MAXIMUM_VALUE 的间隔,则为 true,否则为 false 。
dataCallback 功能 可选 一个函数,它将返回在将每个间隔添加到集合之前调用的数据。如果未指定,数据将是集合中的索引。
result TimeIntervalCollection 可选 用于结果的现有实例。
Returns:
修改后的结果参数或新实例(如果没有提供)。

static Cesium.TimeIntervalCollection.fromJulianDateArray (options, result ) → TimeIntervalCollection

从 JulianDate 数组创建一个新实例。
Name Type Description
options Object 具有以下属性的对象:
姓名 类型 默认 描述
julianDates 数组。< 朱利安日期 > 一组 ISO 8601 日期。
isStartIncluded 布尔值 true 可选 true 开始时间包含在间隔中,则为 true,否则为 false 。
isStopIncluded 布尔值 true 可选 true 停止时间包含在间隔中,则为 true,否则为 false 。
leadingInterval 布尔值 false 可选 true 要添加从 Iso8601.MINIMUM_VALUE 到开始时间的间隔,则为 true,否则为 false 。
trailingInterval 布尔值 false 可选 true 要添加从停止时间到 Iso8601.MAXIMUM_VALUE 的间隔,则为 true,否则为 false 。
dataCallback 功能 可选 一个函数,它将返回在将每个间隔添加到集合之前调用的数据。如果未指定,数据将是集合中的索引。
result TimeIntervalCollection 可选 用于结果的现有实例。
Returns:
修改后的结果参数或新实例(如果没有提供)。

addInterval (interval, dataComparer )

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

contains (julianDate) → Boolean

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

equals ( right , dataComparer ) → Boolean

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

findDataForIntervalContainingDate (date) → Object

查找并返回包含指定日期的时间间隔的数据。
Name Type Description
date JulianDate 要搜索的日期。
Returns:
包含指定日期的区间的数据,如果不存在此类区间,则为 undefined 。

findInterval ( options ) → TimeInterval |undefined

返回集合中与指定参数匹配的第一个区间。所有参数都是可选的, undefined 的参数被视为无关条件。
Name Type Description
options Object 具有以下属性的 可选 对象:
姓名 类型 描述
start 朱利安日期 可选 间隔的开始时间。
stop 朱利安日期 可选 间隔的停止时间。
isStartIncluded 布尔值 可选 如果 options.start 包含在区间中,则为 true ,否则为 false 。
isStopIncluded 布尔值 可选 如果 options.stop 包含在间隔中,则为 true ,否则为 false 。
Returns:
集合中与指定参数匹配的第一个间隔。

findIntervalContainingDate (date) → TimeInterval |undefined

查找并返回包含指定日期的时间间隔。
Name Type Description
date JulianDate 要搜索的日期。
Returns:
包含指定日期的时间间隔,如果不存在这样的时间间隔,则 undefined 。
获取指定索引处的间隔。
Name Type Description
index Number 要检索的间隔的索引。
Returns:
指定索引处的间隔,如果不存在作为该索引的间隔,则为 undefined 。

indexOf (date) → Number

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

intersect (other, dataComparer , mergeCallback ) → TimeIntervalCollection

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

removeInterval (interval) → Boolean

从此间隔集合中删除指定的间隔,在指定的间隔上创建一个洞。输入区间的数据属性被忽略。
Name Type Description
interval TimeInterval 要删除的间隔。
Returns:
如果间隔被删除,则为 true ;如果集合中没有间隔的任何部分,则为 false 。