代表天文朱利安日期,它是自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使用的of秒列表。
获取或设置整天数。
获取或设置当前日期的秒数。
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:
减去时的天数差异
对
从
剩下
。
比较两个实例,如果相等则返回
true
,否则返回
false
。
Name | Type | Description |
---|---|---|
left
|
JulianDate | 可选 一审。 |
right
|
JulianDate | 可选 第二个实例。 |
Returns:
真正
如果日期相等;除此以外,
假
。
比较两个实例,如果它们在距
epsilon
秒之内,则返回
true
彼此。也就是说,为了使日期被认为是相等的(并且对于此函数返回
true
),它们之间的差的绝对值,在秒,必须小于
epsilon
。
Name | Type | Description |
---|---|---|
left
|
JulianDate | 可选 一审。 |
right
|
JulianDate | 可选 第二个实例。 |
epsilon
|
Number | 应该将两个实例分开的最大秒数。 |
Returns:
真正
如果两个日期都在
ε
彼此的秒数;除此以外
假
。
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定义的所有有效格式规范,包括leap秒和毫秒级的时间,大多数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
。
Name | Type | Description |
---|---|---|
left
|
JulianDate | 一审。 |
right
|
JulianDate | 第二个实例。 |
Returns:
真正
如果
剩下
迟于或等于
对
,
假
除此以外。
比较提供的实例,如果
left
早于
right
,则返回
true
,否则返回
false
。
Name | Type | Description |
---|---|---|
left
|
JulianDate | 一审。 |
right
|
JulianDate | 第二个实例。 |
Returns:
真正
如果
剩下
早于
对
,
假
除此以外。
比较提供的实例,如果
left
早于或等于
right
,则返回
true
,否则返回
false
。
Name | Type | Description |
---|---|---|
left
|
JulianDate | 一审。 |
right
|
JulianDate | 第二个实例。 |
Returns:
真正
如果
剩下
早于或等于
对
,
假
除此以外。
static Cesium.JulianDate.now ( result ) → JulianDate
创建一个代表当前系统时间的新实例。这等效于调用
JulianDate.fromDate(new Date());
。
Name | Type | Description |
---|---|---|
result
|
JulianDate | 可选 用于结果的现有实例。 |
Returns:
修改后的结果参数或新实例(如果未提供)。
计算提供的实例之间的时间差(以秒为单位)。
Name | Type | Description |
---|---|---|
left
|
JulianDate | 一审。 |
right
|
JulianDate | 第二个实例。 |
Returns:
减去时的差异(以秒为单位)
对
从
剩下
。
从提供的实例创建一个JavaScript Date。由于JavaScript日期仅精确到最接近的毫秒和无法代表a秒,请考虑改用
JulianDate.toGregorianDate
。如果提供的JulianDate在a秒内,则使用前一秒。
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:
修改后的结果参数或新实例(如果未提供)。
将其与提供的实例进行比较,如果相等则返回
true
,否则返回
false
。
Name | Type | Description |
---|---|---|
right
|
JulianDate | 可选 第二个实例。 |
Returns:
真正
如果日期相等;除此以外,
假
。
将其与提供的实例进行比较,如果它们在距
epsilon
秒的范围内,则返回
true
彼此。也就是说,为了使日期被认为是相等的(并且对于此函数返回
true
),它们之间的差的绝对值,在秒,必须小于
epsilon
。
Name | Type | Description |
---|---|---|
right
|
JulianDate | 可选 第二个实例。 |
epsilon
|
Number | 应该将两个实例分开的最大秒数。 |
Returns:
真正
如果两个日期都在
ε
彼此的秒数;除此以外
假
。
创建以ISO8601格式表示此日期的字符串。
Returns:
以ISO8601格式表示此日期的字符串。