由开始时间和停止时间定义的间隔;可以选择将这些时间作为间隔的一部分。
任意数据可以选择性地与用于
TimeIntervalCollection
的每个实例相关联。Name | Type | Description | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
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
不变的空间隔。
获取或设置与此间隔关联的数据。
获取此间隔是否为空。
获取或设置开始时间是否包含在此间隔中。
-
Default Value:
true
获取或设置停止时间是否包含在此间隔中。
-
Default Value:
true
start : JulianDate
获取或设置此间隔的开始时间。
获取或设置此间隔的停止时间。
Methods
static Cesium.TimeInterval.clone(timeInterval, result) → TimeInterval
复制提供的实例。
Name | Type | Description |
---|---|---|
timeInterval |
TimeInterval | optional 要克隆的实例。 |
result |
TimeInterval | optional 用于结果的现有实例。 |
Returns:
修改后的结果参数或新实例(如果未提供)。
检查指定的日期是否在提供的间隔内。
Name | Type | Description |
---|---|---|
timeInterval |
TimeInterval | 间隔时间。 |
julianDate |
JulianDate | 要检查的日期。 |
Returns:
如果间隔包含指定的日期,则为
true
,否则为false
。比较两个实例,如果相等则返回
true
,否则返回false
。Name | Type | Description |
---|---|---|
left |
TimeInterval | optional 一审。 |
right |
TimeInterval | optional 二审。 |
dataComparer |
TimeInterval.DataComparer | optional 比较两个区间数据的函数。如果省略,则使用引用相等。 |
Returns:
如果日期相等,则为
true
;否则为false
。比较两个实例,如果它们在
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 | 具有以下属性的对象:
|
||||||||||||||||||||
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:
修改后的结果参数。
创建所提供间隔的ISO8601表示形式。
Name | Type | Description |
---|---|---|
timeInterval |
TimeInterval | 要转换的间隔。 |
precision |
Number | optional 用于表示秒组件的小数位数。默认情况下,将使用最精确的表示法。 |
Returns:
提供的间隔的ISO8601表示。
clone(result) → TimeInterval
复制此实例。
Name | Type | Description |
---|---|---|
result |
TimeInterval | optional 用于结果的现有实例。 |
Returns:
修改后的结果参数或新实例(如果未提供)。
将此实例与提供的实例组件进行比较,然后返回
如果相等,则为
true
,否则为false
。Name | Type | Description |
---|---|---|
right |
TimeInterval | optional 右侧间隔。 |
dataComparer |
TimeInterval.DataComparer | optional 比较两个区间数据的函数。如果省略,则使用引用相等。 |
Returns:
如果相等,则为
true
,否则为false
。将此实例与提供的实例组件进行比较,然后返回
true
如果它们在规定的epsilon范围内,
false
否则。Name | Type | Default | Description |
---|---|---|---|
right |
TimeInterval | optional 右侧间隔。 | |
epsilon |
Number |
0
|
optional 用于相等性测试的epsilon。 |
dataComparer |
TimeInterval.DataComparer | optional 比较两个区间数据的函数。如果省略,则使用引用相等。 |
Returns:
如果它们在规定的epsilon范围内,则为
true
,否则为false
。以ISO8601格式创建表示此时间间隔的字符串。
Returns:
以ISO8601格式表示此时间间隔的字符串。
Type Definitions
用于比较区间数据的函数接口。
Name | Type | Description |
---|---|---|
leftData |
* | 第一个数据实例。 |
rightData |
* | 第二个数据实例。 |
Returns:
如果提供的实例相等,则为
true
,否则为false
。用于合并区间数据的函数接口。
Name | Type | Description |
---|---|---|
leftData |
* | 第一个数据实例。 |
rightData |
* | 第二个数据实例。 |
Returns:
合并两个数据实例的结果。