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 true如果options.start包含在区间内,则false则为616668168。
isStopIncluded Boolean true optional true如果options.stop包含在区间内,则false则为616668168。
data Object optional 与此间隔相关联的任意数据。
Examples:
// Create an instance that spans August 1st, 1980 and is associated
// with a Cartesian position.
var 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.
var left = Cesium.TimeInterval.fromIso8601({
    iso8601 : '2000/2010',
    data : 2
});

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

//The result of the below intersection will be an interval equivalent to
//var intersection = Cesium.TimeInterval.fromIso8601({
//  iso8601 : '2000/2005',
//  data : 5
//});
var intersection = new Cesium.TimeInterval();
Cesium.TimeInterval.intersect(left, right, intersection, function(leftData, rightData) {
    return leftData + rightData;
});
// Check if an interval contains a specific time.
var dateToCheck = Cesium.JulianDate.fromIso8601('1982-09-08T11:30:00Z');
var 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
获取或设置此间隔的开始时间。
获取或设置此间隔的停止时间。

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 一审。
right TimeInterval optional 二审。
dataComparer TimeInterval.DataComparer optional 比较两个区间数据的函数。如果省略,则使用引用相等。
Returns:
如果日期相等,则为true;否则为false

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

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

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

ISO 8601间隔创建新实例。
Name Type Description
options Object 具有以下属性的对象:
Name Type Default Description
iso8601 String ISO 8601间隔。
isStartIncluded Boolean true optional true如果options.start包含在区间内,则false则为616668168。
isStopIncluded Boolean true optional true如果options.stop包含在区间内,则false则为616668168。
data Object optional 与此间隔相关联的任意数据。
result TimeInterval optional 用于结果的现有实例。
Returns:
修改后的结果参数或新实例(如果未提供)。
Throws:
  • 显影器错误选项.iso8601与正确的格式不匹配。

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

计算两个区间的交集,可以选择合并它们的数据。
Name Type Description
left TimeInterval 第一个间隔。
right TimeInterval optional 第二个间隔。
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表示。
复制此实例。
Name Type Description
result TimeInterval optional 用于结果的现有实例。
Returns:
修改后的结果参数或新实例(如果未提供)。

equals(right, dataComparer)Boolean

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

equalsEpsilon(right, epsilon, dataComparer)Boolean

将此实例与提供的实例组件进行比较,然后返回 true如果它们在规定的epsilon范围内, false否则。
Name Type Default Description
right TimeInterval optional 右侧间隔。
epsilon Number 0 optional 用于相等性测试的epsilon。
dataComparer TimeInterval.DataComparer optional 比较两个区间数据的函数。如果省略,则使用引用相等。
Returns:
如果它们在规定的epsilon范围内,则为true,否则为false

toString()String

以ISO8601格式创建表示此时间间隔的字符串。
Returns:
以ISO8601格式表示此时间间隔的字符串。

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:
合并两个数据实例的结果。