表示天文儒略日期,即自 -4712 年 1 月 1 日(公元前 4713 年)中午以来的天数。
为了提高精度,此类存储日期和秒的整数部分
部分日期在单独的组件中。 为了安全地进行算术和表示
闰秒,日期始终以国际原子时标准存储
TimeStandard.TAI
的
Name | Type | Default | Description |
---|---|---|---|
julianDayNumber |
number |
0.0
|
optional 儒略日数,表示整天数。 小数天数也将得到正确处理。 |
secondsOfDay |
number |
0.0
|
optional 当前儒略日数的秒数。 秒数的小数部分、负秒数和大于一天的秒数将被正确处理。 |
timeStandard |
TimeStandard |
TimeStandard.UTC
|
optional 定义前两个参数的时间标准。 |
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 | optional 用于结果的现有实例。 |
Returns:
修改后的结果参数 或者如果未提供任何实例,则为新实例。 Returns undefined if julianDate is 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:
从
左
减去右
的差值(以天为单位)。
比较两个实例并返回
true
,否则为false
。
Name | Type | Description |
---|---|---|
left |
JulianDate | optional 第一个instance. |
right |
JulianDate | optional 第二个 instance. |
Returns:
true
如果日期相等;否则为 false
.
比较两个实例并返回
true
如果他们在 epsilon
秒
彼此。 也就是说,为了将日期视为相等(并且
此函数返回 true
), 它们之间差值的绝对值,在
秒,必须小于 epsilon
.
Name | Type | Default | Description |
---|---|---|---|
left |
JulianDate | optional 第一个instance. | |
right |
JulianDate | optional 第二个 instance. | |
epsilon |
number |
0
|
optional 两个实例之间应分隔的最大秒数。 |
Returns:
true
如果日期相等;否则为 false
static Cesium.JulianDate.fromDate(date, result) → JulianDate
从 JavaScript 日期创建新实例。
Name | Type | Description |
---|---|---|
date |
Date | 一个 JavaScript 日期。 |
result |
JulianDate | optional 用于结果的现有实例。 |
Returns:
修改后的结果参数 或者如果未提供任何实例,则为新实例。
Throws:
-
DeveloperError : date must be a valid JavaScript Date.
static Cesium.JulianDate.fromGregorianDate(日期, result) → JulianDate
从 GregorianDate 创建新实例。
Name | Type | Description |
---|---|---|
日期 |
GregorianDate | 一个 GregorianDate。 |
result |
JulianDate | optional 用于结果的现有实例。 |
Returns:
修改后的结果参数 或者如果未提供任何实例,则为新实例。
Throws:
-
DeveloperError : date must be a valid GregorianDate.
static Cesium.JulianDate.fromIso8601(iso8601String, result) → JulianDate
从 ISO 8601 日期。
此方法优于
Date.parse
,因为它将处理 ISO 8601 定义的所有有效格式
规范,包括闰秒和亚毫秒时间,大多数 JavaScript 实现都丢弃了这些时间。
Name | Type | Description |
---|---|---|
iso8601String |
string | ISO 8601 日期。 |
result |
JulianDate | optional 用于结果的现有实例。 |
Returns:
修改后的结果参数 或者如果未提供任何实例,则为新实例。
Throws:
-
DeveloperError : Invalid ISO 8601 date.
比较提供的实例并返回 如果
left
晚于 right
,则为 true
,否则 false
。
Name | Type | Description |
---|---|---|
left |
JulianDate | 第一个实例。 |
right |
JulianDate | 第二个实例。 |
Returns:
如果
left
晚于 right
,则为 true
,否则 false
。
比较提供的实例并返回 如果 , 否则
left
晚于或等于 right
,>则为 false
。
Name | Type | Description |
---|---|---|
left |
JulianDate | 第一个实例。 |
right |
JulianDate | 第二个实例。 |
Returns:
如果 , 否则
left
晚于或等于 right
,>则为 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:
早于或等于
right
,则为 true
,否则false
。
static Cesium.JulianDate.now(result) → JulianDate
创建表示当前系统时间的新实例。
这相当于调用
JulianDate.fromDate(new Date());
。
Name | Type | Description |
---|---|---|
result |
JulianDate | optional 用于结果的现有实例。 |
Returns:
修改后的结果参数 或者如果未提供任何实例,则为新实例。
计算提供的实例之间的秒差。
Name | Type | Description |
---|---|---|
left |
JulianDate | 第一个实例。 |
right |
JulianDate | 第二个实例。 |
Returns:
从
left
中减去 right
时的差值(以秒为单位)。
从提供的实例创建 JavaScript Date。
由于 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 | optional 用于结果的现有实例。 |
Returns:
修改后的结果参数 或者如果未提供任何实例,则为新实例。
创建所提供日期的ISO8601表示形式。
Name | Type | Description |
---|---|---|
julianDate |
JulianDate | 要转换的日期。 |
precision |
number | optional 用于表示秒部分的小数位数。 默认情况下,使用最精确的表示。 |
Returns:
所提供日期的ISO8601表示形式。
计算提供的实例表示的整数天和小数天的总天数。
Name | Type | Description |
---|---|---|
julianDate |
JulianDate | 日期。 |
Returns:
儒略日期为单个浮点数。
clone(result) → JulianDate
复制实例
Name | Type | Description |
---|---|---|
result |
JulianDate | optional 用于结果的现有实例。 |
Returns:
修改后的结果参数 或者如果未提供任何实例,则为新实例。
将此实例与提供的实例进行比较,并返回
true
,否则为false
。
Name | Type | Description |
---|---|---|
right |
JulianDate | optional 第二个 instance. |
Returns:
如果日期相等,
则为 true
;否则为 false
。
将此实例与提供的实例进行比较,如果它们在
epsilon
秒内,则返回 true
彼此。 也就是说,为了将日期视为相等(并且
此函数返回 true
),则表示它们之间差值的绝对值,在
秒,必须小于 epsilon
。
Name | Type | Default | Description |
---|---|---|---|
right |
JulianDate | optional 第二个 instance. | |
epsilon |
number |
0
|
optional 两个实例之间应分隔的最大秒数。 |
Returns:
true
如果日期相等;否则为 false
创建一个字符串,以 ISO8601 格式表示此日期。
Returns:
以 ISO8601 格式表示此日期的字符串。