由开始和停止时间定义的间隔;(可选)将这些时间作为间隔的一部分包括在内。
可以选择将任意数据与每个实例相关联,以便与
TimeIntervalCollection
一起使用。
Name | Type | Description | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
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
不可变的空间隔。
获取或设置与此间隔关联的数据。
获取是否此间隔为空。
获取或设置是否开始时间包含在此间隔中。
-
Default Value:
true
获取或设置是否停止时间包含在此间隔中。
-
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:
修改后的结果参数或新实例(如果未提供)。
检查指定的日期是否在提供的间隔内。
Name | Type | Description |
---|---|---|
timeInterval |
TimeInterval | 间隔。 |
julianDate |
JulianDate | 要检查的日期。 |
Returns:
true
(如果区间包含指定日期),否则 false
,。
比较两个实例并返回
true
,否则为false
。
Name | Type | Description |
---|---|---|
left |
TimeInterval | optional 第一个instance. |
right |
TimeInterval | optional 第二个 instance. |
dataComparer |
TimeInterval.DataComparer | optional 比较两个区间的数据的函数。 如果省略,则使用引用相等。 |
Returns:
如果日期相等,
则为 true
;否则为 false
.
比较两个实例
,如果它们在
彼此。 也就是说,为了将日期视为相等(并且
此函数返回 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 |
对象,具有以下属性:
|
||||||||||||||||||||
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:
修改后的结果参数。
创建所提供间隔的 ISO8601 表示形式。
Name | Type | Description |
---|---|---|
timeInterval |
TimeInterval | 需要转换的间隔。 |
precision |
number | optional 用于表示秒部分的小数位数。 默认情况下,使用最精确的表示。 |
Returns:
提供的区间的 ISO8601 表示形式。
clone(result) → TimeInterval
复制TimeInterval
Name | Type | Description |
---|---|---|
result |
TimeInterval | optional |
Returns:
修改后的结果参数或者如果未提供任何实例,则为新实例。
将此实例与提供的实例 componentwise 进行比较,并返回
true
,否则为 false
。
Name | Type | Description |
---|---|---|
right |
TimeInterval | optional 右边 interval. |
dataComparer |
TimeInterval.DataComparer | optional 比较两个区间的数据的函数。 如果省略,则使用引用相等。 |
Returns:
true
,否则为false
。
将此实例与提供的实例 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
用于比较间隔数据的功能接口。
Name | Type | Description |
---|---|---|
leftData |
* | 第一个数据实例。 |
rightData |
* | 第二个数据实例。 |
Returns:
true
(如果提供的实例相等),否则 false
。
用于合并间隔数据的功能接口。
Name | Type | Description |
---|---|---|
leftData |
* | 第一个数据实例。 |
rightData |
* | 第二个数据实例。 |
Returns:
合并两个数据实例的结果。