表示天文儒略日期,即自 -4712 年 1 月 1 日(公元前 4713 年)中午以来的天数。为了提高精度,此类将日期的整数部分和日期的秒部分存储在单独的组件中。为了算术安全并表示闰秒,日期始终存储在国际原子时间标准
TimeStandard.TAI
中。
Name | Type | Default | Description |
---|---|---|---|
julianDayNumber
|
Number |
0.0
|
可选 的儒略日数,代表天数。小数天也将得到正确处理。 |
secondsOfDay
|
Number |
0.0
|
可选 进入当前儒略日数的秒数。将正确处理小数秒、负秒和大于一天的秒。 |
timeStandard
|
TimeStandard |
TimeStandard.UTC
|
可选 定义前两个参数的时间标准。 |
Members
static Cesium.JulianDate.leapSeconds : Array.< LeapSecond >
获取或设置整个 Cesium 中使用的闰秒列表。
获取或设置天数。
获取或设置到当前日期的秒数。
Methods
static Cesium.JulianDate.addDays (julianDate, days, result) → JulianDate
将提供的天数添加到提供的日期实例。
Name | Type | Description |
---|---|---|
julianDate
|
JulianDate | 日期。 |
days
|
Number | 要增加或减少的天数。 |
result
|
JulianDate | 用于结果的现有实例。 |
Returns:
修改后的结果参数。
static Cesium.JulianDate.addHours (julianDate, hours, result) → JulianDate
将提供的小时数添加到提供的日期实例。
Name | Type | Description |
---|---|---|
julianDate
|
JulianDate | 日期。 |
hours
|
Number | 要增加或减少的小时数。 |
result
|
JulianDate | 用于结果的现有实例。 |
Returns:
修改后的结果参数。
static Cesium.JulianDate.addMinutes (julianDate, minutes, result) → JulianDate
将提供的分钟数添加到提供的日期实例。
Name | Type | Description |
---|---|---|
julianDate
|
JulianDate | 日期。 |
minutes
|
Number | 添加或减去的分钟数。 |
result
|
JulianDate | 用于结果的现有实例。 |
Returns:
修改后的结果参数。
static Cesium.JulianDate.addSeconds (julianDate, seconds, result) → JulianDate
将提供的秒数添加到提供的日期实例。
Name | Type | Description |
---|---|---|
julianDate
|
JulianDate | 日期。 |
seconds
|
Number | 添加或减去的秒数。 |
result
|
JulianDate | 用于结果的现有实例。 |
Returns:
修改后的结果参数。
static Cesium.JulianDate.clone (julianDate, result ) → JulianDate
复制 JulianDate 实例。
Name | Type | Description |
---|---|---|
julianDate
|
JulianDate | 要复制的日期。 |
result
|
JulianDate | 可选 用于结果的现有实例。 |
Returns:
修改后的结果参数或新实例(如果没有提供)。如果 julianDate 未定义,则返回 undefined。
比较两个实例。
Name | Type | Description |
---|---|---|
left
|
JulianDate | 第一个实例。 |
right
|
JulianDate | 第二种情况。 |
Returns:
如果left小于right,则为负值,如果left大于right,则为正值,如果left和right相等,则为零。
计算提供的实例领先于 UTC 的秒数。
Name | Type | Description |
---|---|---|
julianDate
|
JulianDate | 日期。 |
Returns:
提供的实例领先于 UTC 的秒数
计算提供的实例之间的天数差异。
Name | Type | Description |
---|---|---|
left
|
JulianDate | 第一个实例。 |
right
|
JulianDate | 第二种情况。 |
Returns:
left
减去
right
时的差异,以天为单位。
比较两个实例,如果相等则返回
true
,否则返回
false
。
Name | Type | Description |
---|---|---|
left
|
JulianDate | 可选 第一个实例。 |
right
|
JulianDate | 可选 第二个实例。 |
Returns:
如果日期相等,则为
true
;否则,
false
。
比较两个实例,如果它们在
epsilon
秒内,则返回
true
。也就是说,为了使日期被视为相等(并且此函数返回
true
),它们之间的差异的绝对值(以秒为单位)必须小于
epsilon
。
Name | Type | Default | Description |
---|---|---|---|
left
|
JulianDate | 可选 第一个实例。 | |
right
|
JulianDate | 可选 第二个实例。 | |
epsilon
|
Number |
0
|
可选 应该分隔两个实例的最大秒数。 |
Returns:
如果两个日期在
epsilon
秒内,则为
true
;否则
false
。
static Cesium.JulianDate.fromDate (date, result ) → JulianDate
从 JavaScript 日期创建一个新实例。
Name | Type | Description |
---|---|---|
date
|
Date | JavaScript 日期。 |
result
|
JulianDate | 可选 用于结果的现有实例。 |
Returns:
修改后的结果参数或新实例(如果没有提供)。
Throws:
-
DeveloperError :日期必须是有效的 JavaScript 日期。
static Cesium.JulianDate.fromGregorianDate (date, result ) → JulianDate
从 GregorianDate 创建一个新实例。
Name | Type | Description |
---|---|---|
date
|
GregorianDate | 一个公历日期。 |
result
|
JulianDate | 可选 用于结果的现有实例。 |
Returns:
修改后的结果参数或新实例(如果没有提供)。
Throws:
-
DeveloperError : 日期必须是有效的 GregorianDate。
static Cesium.JulianDate.fromIso8601 (iso8601String, result ) → JulianDate
从
ISO 8601
日期创建一个新实例。此方法优于
Date.parse
,因为它将处理 ISO 8601 规范定义的所有有效格式,包括闰秒和亚毫秒时间,大多数 JavaScript 实现都丢弃了这些格式。
Name | Type | Description |
---|---|---|
iso8601String
|
String | ISO 8601 日期。 |
result
|
JulianDate | 可选 用于结果的现有实例。 |
Returns:
修改后的结果参数或新实例(如果没有提供)。
Throws:
-
DeveloperError :无效的 ISO 8601 日期。
比较提供的实例,如果
left
晚于
right
则返回
true
,否则返回
false
。
Name | Type | Description |
---|---|---|
left
|
JulianDate | 第一个实例。 |
right
|
JulianDate | 第二种情况。 |
Returns:
如果
left
晚于
right
则为
true
,否则为
false
。
比较提供的实例,如果
left
晚于或等于
right
则返回
true
,否则返回
false
。
Name | Type | Description |
---|---|---|
left
|
JulianDate | 第一个实例。 |
right
|
JulianDate | 第二种情况。 |
Returns:
如果
left
晚于或等于
right
,则为
true
,否则为
false
。
比较提供的实例,如果
left
早于
right
则返回
true
,否则返回
false
。
Name | Type | Description |
---|---|---|
left
|
JulianDate | 第一个实例。 |
right
|
JulianDate | 第二种情况。 |
Returns:
如果
left
早于
right
,则为
true
,否则为
false
。
比较提供的实例,如果
left
早于或等于
right
则返回
true
,否则返回
false
。
Name | Type | Description |
---|---|---|
left
|
JulianDate | 第一个实例。 |
right
|
JulianDate | 第二种情况。 |
Returns:
如果
left
早于或等于
right
,则为
true
,否则为
false
。
static Cesium.JulianDate.now ( result ) → JulianDate
创建一个表示当前系统时间的新实例。这相当于调用
JulianDate.fromDate(new Date());
.
Name | Type | Description |
---|---|---|
result
|
JulianDate | 可选 用于结果的现有实例。 |
Returns:
修改后的结果参数或新实例(如果没有提供)。
计算提供的实例之间的秒数差异。
Name | Type | Description |
---|---|---|
left
|
JulianDate | 第一个实例。 |
right
|
JulianDate | 第二种情况。 |
Returns:
left
减去
right
时的差异,以秒为单位。
从提供的实例创建一个 JavaScript 日期。由于 JavaScript 日期仅精确到最接近的毫秒并且不能表示闰秒,因此请考虑改用
JulianDate.toGregorianDate
。如果提供的 JulianDate 在闰秒期间,则使用前一秒。
Name | Type | Description |
---|---|---|
julianDate
|
JulianDate | 要转换的日期。 |
Returns:
表示提供的日期的新实例。
static Cesium.JulianDate.toGregorianDate (julianDate, result ) → GregorianDate
从提供的实例创建一个
GregorianDate
。
Name | Type | Description |
---|---|---|
julianDate
|
JulianDate | 要转换的日期。 |
result
|
GregorianDate | 可选 用于结果的现有实例。 |
Returns:
修改后的结果参数或新实例(如果没有提供)。
创建所提供日期的 ISO8601 表示。
Name | Type | Description |
---|---|---|
julianDate
|
JulianDate | 要转换的日期。 |
precision
|
Number | 可选 用于表示秒组件的小数位数。默认情况下,使用最精确的表示。 |
Returns:
提供日期的 ISO8601 表示。
计算由提供的实例表示的整数天和小数天的总数。
Name | Type | Description |
---|---|---|
julianDate
|
JulianDate | 日期。 |
Returns:
儒略日期为单浮点数。
clone ( result ) → JulianDate
复制此实例。
Name | Type | Description |
---|---|---|
result
|
JulianDate | 可选 用于结果的现有实例。 |
Returns:
修改后的结果参数或新实例(如果没有提供)。
比较 this 和提供的实例,如果相等则返回
true
,否则返回
false
。
Name | Type | Description |
---|---|---|
right
|
JulianDate | 可选 第二个实例。 |
Returns:
如果日期相等,则为
true
;否则,
false
。
比较这个和提供的实例,如果它们在
epsilon
秒内,则返回
true
。也就是说,为了使日期被视为相等(并且此函数返回
true
),它们之间的差异的绝对值(以秒为单位)必须小于
epsilon
。
Name | Type | Default | Description |
---|---|---|---|
right
|
JulianDate | 可选 第二个实例。 | |
epsilon
|
Number |
0
|
可选 应该分隔两个实例的最大秒数。 |
Returns:
如果两个日期在
epsilon
秒内,则为
true
;否则
false
。
创建一个以 ISO8601 格式表示此日期的字符串。
Returns:
以 ISO8601 格式表示此日期的字符串。