TimeInterval

new Cesium.TimeInterval(options)

由开始和停止时间定义的间隔;(可选)将这些时间作为间隔的一部分包括在内。 可以选择将任意数据与每个实例相关联,以便与 TimeIntervalCollection 一起使用。
Name Type Description
options object optional 对象,具有以下属性:
Name Type Default Description
start JulianDate new JulianDate() optional 区间的开始时间。
stop JulianDate new JulianDate() optional 区间的停止时间。
isStartIncluded boolean true optional 如果 options.start 包含在区间中,则为 true, 否则 false
isStopIncluded boolean true optional 如果 options.stop 包含在区间内,则为 true, 否则 false
data object optional 与此区间关联的任意数据。
Examples:
// Create an instance that spans August 1st, 1980 and is associated
// with a Cartesian position.
const timeInterval = new Cesium.TimeInterval({
    start : Cesium.JulianDate.fromIso8601('1980-08-01T00:00:00Z'),
    stop : Cesium.JulianDate.fromIso8601('1980-08-02T00:00:00Z'),
    isStartIncluded : true,
    isStopIncluded : false,
    data : Cesium.Cartesian3.fromDegrees(39.921037, -75.170082)
});
// Create two instances from ISO 8601 intervals with associated numeric data
// then compute their intersection, summing the data they contain.
const left = Cesium.TimeInterval.fromIso8601({
    iso8601 : '2000/2010',
    data : 2
});

const right = Cesium.TimeInterval.fromIso8601({
    iso8601 : '1995/2005',
    data : 3
});

//The result of the below intersection will be an interval equivalent to
//const intersection = Cesium.TimeInterval.fromIso8601({
//  iso8601 : '2000/2005',
//  data : 5
//});
const intersection = new Cesium.TimeInterval();
Cesium.TimeInterval.intersect(left, right, intersection, function(leftData, rightData) {
    return leftData + rightData;
});
// Check if an interval contains a specific time.
const dateToCheck = Cesium.JulianDate.fromIso8601('1982-09-08T11:30:00Z');
const containsDate = Cesium.TimeInterval.contains(timeInterval, dateToCheck);

Members

static constant Cesium.TimeInterval.EMPTY : TimeInterval

不可变的空间隔。
获取或设置与此间隔关联的数据。

readonly isEmpty : boolean

获取是否此间隔为空。

isStartIncluded : boolean

获取或设置是否开始时间包含在此间隔中。
Default Value: true

isStopIncluded : boolean

获取或设置是否停止时间包含在此间隔中。
Default Value: true
获取或设置start time of this interval.
获取或设置stop time of this interval.

Methods

static Cesium.TimeInterval.clone(timeInterval, result)TimeInterval

复制提供的实例。
Name Type Description
timeInterval TimeInterval optional 要克隆的实例。
result TimeInterval optional 用于结果的现有实例。
Returns:
修改后的结果参数或新实例(如果未提供)。

static Cesium.TimeInterval.contains(timeInterval, julianDate)boolean

检查指定的日期是否在提供的间隔内。
Name Type Description
timeInterval TimeInterval 间隔。
julianDate JulianDate 要检查的日期。
Returns:
true(如果区间包含指定日期),否则 false,。

static Cesium.TimeInterval.equals(left, right, dataComparer)boolean

比较两个实例并返回 true,否则为false
Name Type Description
left TimeInterval optional 第一个instance.
right TimeInterval optional 第二个 instance.
dataComparer TimeInterval.DataComparer optional 比较两个区间的数据的函数。 如果省略,则使用引用相等。
Returns:
如果日期相等,则为 true;否则为 false.

static Cesium.TimeInterval.equalsEpsilon(left, right, epsilon, dataComparer)boolean

比较两个实例,如果它们在 彼此。 也就是说,为了将日期视为相等(并且 此函数返回 true),则表示它们之间差值的绝对值,在 秒,必须小于 epsilon
Name Type Default Description
left TimeInterval optional 第一个instance.
right TimeInterval optional 第二个 instance.
epsilon number 0 optional 两个实例之间应分隔的最大秒数。
dataComparer TimeInterval.DataComparer optional 比较两个区间数据的函数。 如果省略,则使用引用相等。
Returns:
true,如果两个日期彼此相差在 epsilon 秒内;否则为 false

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

ISO 8601 间隔。 如果 options.iso8601 与正确的格式不匹配,则@throws DeveloperError。
Name Type Description
options object 对象,具有以下属性:
Name Type Default Description
iso8601 string ISO 8601 间隔。
isStartIncluded boolean true optional 如果 options.start 包含在区间中,则为 true, 否则 false
isStopIncluded boolean true optional 如果 options.stop 包含在区间内,则为 true, 否则 false
data object optional 与此区间关联的任意数据。
result TimeInterval optional 用于结果的现有实例。
Returns:
修改后的结果参数或新实例(如果未提供)。

static Cesium.TimeInterval.intersect(left, right, result, mergeCallback)TimeInterval

计算两个区间的交集,可以选择合并其数据。
Name Type Description
left TimeInterval 第一个 interval.
right TimeInterval optional 第二个 interval.
result TimeInterval optional 用于结果的现有实例。
mergeCallback TimeInterval.MergeCallback optional 合并两个区间数据的函数。如果省略,则将使用左侧间隔中的数据。
Returns:
修改后的结果参数。

static Cesium.TimeInterval.toIso8601(timeInterval, precision)string

创建所提供间隔的 ISO8601 表示形式。
Name Type Description
timeInterval TimeInterval 需要转换的间隔。
precision number optional 用于表示秒部分的小数位数。 默认情况下,使用最精确的表示。
Returns:
提供的区间的 ISO8601 表示形式。
复制TimeInterval
Name Type Description
result TimeInterval optional
Returns:
修改后的结果参数或者如果未提供任何实例,则为新实例。

equals(right, dataComparer)boolean

将此实例与提供的实例 componentwise 进行比较,并返回 true,否则为 false
Name Type Description
right TimeInterval optional 右边 interval.
dataComparer TimeInterval.DataComparer optional 比较两个区间的数据的函数。 如果省略,则使用引用相等。
Returns:
true,否则为false

equalsEpsilon(right, epsilon, dataComparer)boolean

将此实例与提供的实例 componentwise 进行比较,并返回 true,如果它们位于提供的 epsilon 内, 否则false
Name Type Default Description
right TimeInterval optional 右边 interval.
epsilon number 0 optional 用来检验等式。
dataComparer TimeInterval.DataComparer optional 比较两个区间的数据的函数。 如果省略,则使用引用相等。
Returns:
true如果它们在提供的epsilon内,否则 false
以 ISO8601 格式创建表示此 TimeInterval 的字符串。
Returns:
以 ISO8601 格式表示此 TimeInterval 的字符串。

Type Definitions

Cesium.TimeInterval.DataComparer(leftData, rightData)boolean

用于比较间隔数据的功能接口。
Name Type Description
leftData * 第一个数据实例。
rightData * 第二个数据实例。
Returns:
true(如果提供的实例相等),否则 false

Cesium.TimeInterval.MergeCallback(leftData, rightData)*

用于合并间隔数据的功能接口。
Name Type Description
leftData * 第一个数据实例。
rightData * 第二个数据实例。
Returns:
合并两个数据实例的结果。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.