表示天文学的儒略日期,即自公元前4712年1月1日中午以来的天数(4713 BC)。
为了提高精确度,此类将日期的整数部分和秒数部分存储在单独的组件中。
为了安全进行算术运算并表示闰秒,日期始终按照国际原子时间标准
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:
修改后的结果参数,如果未提供则返回一个新实例。如果 julianDate 是 undefined,返回 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 | optional 第一个实例。 |
right |
JulianDate | optional 第二个实例。 |
Returns:
如果日期相等,则返回
true;否则返回 false。
比较两个实例并返回
true 如果它们之间的差值在 epsilon 秒以内。
也就是说,要认为日期相等(并且此函数返回 true),
它们之间的绝对差值(以秒为单位)必须小于 epsilon。
| Name | Type | Default | Description |
|---|---|---|---|
left |
JulianDate | optional 第一个实例。 | |
right |
JulianDate | optional 第二个实例。 | |
epsilon |
number |
0
|
optional 应该使两个实例分开的最大秒数。 |
Returns:
如果两个日期相差在
epsilon 秒以内,则返回 true;否则返回 false。
static Cesium.JulianDate.fromDate(date, result) → JulianDate
从 JavaScript Date 创建一个新实例。
| Name | Type | Description |
|---|---|---|
date |
Date | 一个 JavaScript Date 对象。 |
result |
JulianDate | optional 要用于结果的现有实例。 |
Returns:
修改后的结果参数,如果未提供则返回一个新实例。
Throws:
-
DeveloperError : date 必须是有效的 JavaScript Date。
static Cesium.JulianDate.fromGregorianDate(date, result) → JulianDate
从 GregorianDate 创建一个新实例。
| Name | Type | Description |
|---|---|---|
date |
GregorianDate | 一个 GregorianDate。 |
result |
JulianDate | optional 要用于结果的现有实例。 |
Returns:
修改后的结果参数,如果未提供则返回一个新实例。
Throws:
-
DeveloperError : date 必须是有效的 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 : 无效的 ISO 8601 日期。
比较提供的实例,并返回
true 如果 left 晚于 right,否则返回 false。
| Name | Type | Description |
|---|---|---|
left |
JulianDate | 第一个实例。 |
right |
JulianDate | 第二个实例。 |
Returns:
如果
left 晚于 right,则返回 true;否则返回 false。
比较提供的实例,并返回
true 如果 left 晚于或等于 right,否则返回 false。
| Name | Type | Description |
|---|---|---|
left |
JulianDate | 第一个实例。 |
right |
JulianDate | 第二个实例。 |
Returns:
如果
left 晚于或等于 right,则返回 true;否则返回 false。
比较提供的实例,并返回
true 如果 left 早于 right,否则返回 false。
| Name | Type | Description |
|---|---|---|
left |
JulianDate | 第一个实例。 |
right |
JulianDate | 第二个实例。 |
Returns:
如果
left 早于 right,则返回 true;否则返回 false。
比较提供的实例,并返回
true 如果 left 早于或等于 right,否则返回 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 | 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 第二个实例。 |
Returns:
如果日期相等,则返回
true;否则返回 false。
比较此实例和提供的实例,并返回
true 如果它们之间的差值在 epsilon 秒以内。
也就是说,要认为日期相等(并且此函数返回 true),
它们之间的绝对差值(以秒为单位)必须小于 epsilon。
| Name | Type | Default | Description |
|---|---|---|---|
right |
JulianDate | optional 第二个实例。 | |
epsilon |
number |
0
|
optional 应该使两个实例分开的最大秒数。 |
Returns:
如果两个日期相差在
epsilon 秒以内,则返回 true;否则返回 false。
创建一个字符串,表示此日期的 ISO8601 格式。
Returns:
一个表示此日期的 ISO8601 格式的字符串。
