new Cesium.JulianDate(julianDayNumber, secondsOfDay, timeStandard)
代表一个天文学的儒略日期,它是自-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 定义前两个参数的时间标准。 |
成员变量
获取或设置在Cesium中使用的闰秒列表。
dayNumber : Number
Gets or sets the number of whole days.
secondsOfDay : Number
Gets or sets the number of seconds into the current day.
内置方法
将提供的天数添加到提供的日期实例。
Name | Type | Description |
---|---|---|
julianDate |
JulianDate | 日期。 |
days |
Number | 要加或减的天数。 |
result |
JulianDate | 要用于结果的现有实例。 |
返回值:
修改后的结果参数。
将提供的小时数添加到提供的日期实例。
Name | Type | Description |
---|---|---|
julianDate |
JulianDate | 日期。 |
hours |
Number | 要加或减的小时数。 |
result |
JulianDate | 要用于结果的现有实例。 |
返回值:
修改后的结果参数。
将提供的分钟数添加到提供的日期实例。
Name | Type | Description |
---|---|---|
julianDate |
JulianDate | 日期。 |
minutes |
Number | 要加或减的分钟数。 |
result |
JulianDate | 要用于结果的现有实例。 |
返回值:
修改后的结果参数。
将提供的秒数添加到提供的日期实例。
Name | Type | Description |
---|---|---|
julianDate |
JulianDate | 日期。 |
seconds |
Number | 要加或减的秒数。 |
result |
JulianDate | 要用于结果的现有实例。 |
返回值:
修改后的结果参数。
复制一个JulianDate实例。
Name | Type | Description |
---|---|---|
julianDate |
JulianDate | 要被复制的日期。 |
result |
JulianDate | optional 要用于结果的现有实例。 |
返回值:
修改后的结果参数或新实例(如果没有提供)。 如果julianDate未定义,则返回undefined。
比较两个实例
Name | Type | Description |
---|---|---|
left |
JulianDate | 第一个实例。 |
right |
JulianDate | 第二个实例。 |
返回值:
如果左边小于右边,则为负值;如果左边大于右边,则为正值;如果左右相等,则为零。
计算提供的实例先于UTC的秒数。
Name | Type | Description |
---|---|---|
julianDate |
JulianDate | 日期。 |
返回值:
提供的实例先于UTC的秒数
计算所提供实例之间的天数差。
Name | Type | Description |
---|---|---|
left |
JulianDate | 第一个实例。 |
right |
JulianDate | 第二个实例。 |
返回值:
差值,以天为单位,将
right
从left
中减去。
比较两个实例,如果相等,则返回
true
,否则返回false
。
Name | Type | Description |
---|---|---|
left |
JulianDate | optional 第一个实例。 |
right |
JulianDate | optional 第二个实例。 |
返回值:
true
如果日期相等;否则为false
。
比较两个实例,如果它们在
epsilon
秒内,则返回true
。
也就是说,为了使日期被认为是相等的(就是这个函数要返回true
),
它们之间的差的绝对值(以秒为单位)必须小于epsilon
。
Name | Type | Description |
---|---|---|
left |
JulianDate | optional 第一个实例。 |
right |
JulianDate | optional 第二个实例。 |
epsilon |
Number | 两个实例间的最大秒数。 |
返回值:
true
如果两个日期在epsilon
秒内;否则为false
。
从一个JavaScript日期创建一个新实例。
Name | Type | Description |
---|---|---|
date |
Date | 一个JavaScript 日期。 |
result |
JulianDate | optional 要用于结果的现有实例。 |
返回值:
修改后的结果参数或新实例(如果没有提供)。
异常情况:
-
DeveloperError : 日期必须是一个有效的JavaScript Date。
从一个GregorianDate创建一个新实例。
Name | Type | Description |
---|---|---|
date |
GregorianDate | 一个GregorianDate. |
result |
JulianDate | optional 要用于结果的现有实例。 |
返回值:
修改后的结果参数或新实例(如果没有提供)。
异常情况:
-
DeveloperError : 日期必须是一个有效的GregorianDate.
从一个 ISO 8601日期创建一个新实例。
此方法优于
Date.parse
,因为它将处理ISO 8601规范定义的所有有效格式,
包括闰秒和亚毫秒级时间,大多数JavaScript实现都废弃了这两个时间。
Name | Type | Description |
---|---|---|
iso8601String |
String | 一个ISO 8601 日期。 |
result |
JulianDate | optional 要用于结果的现有实例。 |
返回值:
修改后的结果参数或新实例(如果没有提供)。
异常情况:
-
DeveloperError : 无效的ISO 8601 日期。
比较提供的实例,如果
left
晚于right
,则返回true
,否则返回 false
。
Name | Type | Description |
---|---|---|
left |
JulianDate | 第一个实例。 |
right |
JulianDate | 第二个实例。 |
返回值:
true
如果 left
晚于 right
, 否则false
。
比较提供的实例,如果
left
晚于或等于right
,则返回true
,否则返回 false
。
Name | Type | Description |
---|---|---|
left |
JulianDate | 第一个实例。 |
right |
JulianDate | 第二个实例。 |
返回值:
true
如果 left
晚于或等于 right
, 否则false
。
比较提供的实例,如果
left
早于 right
,则返回 true
,否则返回 false
。
Name | Type | Description |
---|---|---|
left |
JulianDate | 第一个实例。 |
right |
JulianDate | 第二个实例。 |
返回值:
true
如果 left
早于 right
, 否则false
。
比较提供的实例,如果
left
早于或等于 right
,则返回 true
,否则返回 false
。
Name | Type | Description |
---|---|---|
left |
JulianDate | 第一个实例。 |
right |
JulianDate | 第二个实例。 |
返回值:
true
如果 left
早于或等于 right
, 否则false
。
创建一个代表当前系统时间的新实例。
这等效于调用
JulianDate.fromDate(new Date());
.
Name | Type | Description |
---|---|---|
result |
JulianDate | optional 要用于结果的现有实例。 |
返回值:
修改后的结果参数或新实例(如果没有提供)。
计算提供的实例之间的秒差。
Name | Type | Description |
---|---|---|
left |
JulianDate | 第一个实例。 |
right |
JulianDate | 第二个实例。 |
返回值:
差值,以秒为单位,将
right
从left
中减去。
从提供的实例创建一个JavaScript Date。
由于JavaScript日期只能精确到最接近的毫秒,不能代表闰秒,因此可以考虑改用
JulianDate.toGregorianDate
。
如果提供的JulianDate在闰秒期间,则使用之前的秒。
Name | Type | Description |
---|---|---|
julianDate |
JulianDate | 要转换的日期。 |
返回值:
代表提供的日期的新实例。
从提供的实例中创建一个
GregorianDate
。
Name | Type | Description |
---|---|---|
julianDate |
JulianDate | 要转换的日期。 |
result |
GregorianDate | optional 要用于结果的现有实例。 |
返回值:
修改后的结果参数或新实例(如果没有提供)。
创建所提供日期的ISO8601表示形式。
Name | Type | Description |
---|---|---|
julianDate |
JulianDate | 要转换的日期。 |
precision |
Number | optional 用于表示秒分量的小数位数。 默认情况下,使用最精确的表示形式。 |
返回值:
所提供日期的ISO8601表示形式。
计算提供的实例代表的整天和小数天的总数。
Name | Type | Description |
---|---|---|
julianDate |
JulianDate | 日期。 |
返回值:
儒略日期作为单浮点数。
Duplicates this instance.
Name | Type | Description |
---|---|---|
result |
JulianDate | optional An existing instance to use for the result. |
返回值:
The modified result parameter or a new instance if none was provided.
Compares this and the provided instance and returns
true
if they are equal, false
otherwise.
Name | Type | Description |
---|---|---|
right |
JulianDate | optional The second instance. |
返回值:
true
if the dates are equal; otherwise, false
.
Compares this and the provided instance and returns
true
if they are within epsilon
seconds of
each other. That is, in order for the dates to be considered equal (and for
this function to return true
), the absolute value of the difference between them, in
seconds, must be less than epsilon
.
Name | Type | Description |
---|---|---|
right |
JulianDate | optional The second instance. |
epsilon |
Number | The maximum number of seconds that should separate the two instances. |
返回值:
true
if the two dates are within epsilon
seconds of each other; otherwise false
.
以ISO8601格式创建表示此日期的字符串。
返回值:
用ISO8601格式表示此日期的字符串。