表示天文儒略日期,是自1月1日中午起的天数,-4712(公元前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>
获取或设置在整个铯原子中使用的闰秒列表。
获取或设置整天数。
获取或设置当前日期的秒数。
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。
比较两个实例。
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
。比较两个实例,如果它们在
epsilon
秒内,则返回true
彼此。也就是说,为了使日期被认为是相等的(并且
此函数返回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日期创建新实例。
Name | Type | Description |
---|---|---|
date |
Date | JavaScript日期。 |
result |
JulianDate | optional 用于结果的现有实例。 |
Returns:
修改后的结果参数或新实例(如果未提供)。
Throws:
-
DeveloperError :date必须是有效的JavaScript日期。
static Cesium.JulianDate.fromGregorianDate(date, result) → JulianDate
从GregorianDate创建新实例。
Name | Type | Description |
---|---|---|
date |
GregorianDate | 公历日期。 |
result |
JulianDate | optional 用于结果的现有实例。 |
Returns:
修改后的结果参数或新实例(如果未提供)。
Throws:
-
DeveloperError :日期必须是有效的GregorianDate。
static Cesium.JulianDate.fromIso8601(iso8601String, result) → JulianDate
从ISO 8601日期创建新实例。
此方法优于
Date.parse
,因为它可以处理ISO8601定义的所有有效格式
规范,包括闰秒和亚毫秒时间,这被大多数JavaScript实现所放弃。Name | Type | Description |
---|---|---|
iso8601String |
String | ISO 8601日期。 |
result |
JulianDate | optional 用于结果的现有实例。 |
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 | optional 用于结果的现有实例。 |
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 | 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
。将此实例与提供的实例进行比较,如果它们在
epsilon
秒之内,则返回true
彼此。也就是说,为了使日期被认为是相等的(并且
此函数返回true
),它们之间差的绝对值,在
秒,必须小于epsilon
。Name | Type | Default | Description |
---|---|---|---|
right |
JulianDate | optional 二审。 | |
epsilon |
Number |
0
|
optional 分隔两个实例的最大秒数。 |
Returns:
如果两个日期相距在
epsilon
秒之内,则为true
;否则为false
。以ISO8601格式创建表示此日期的字符串。
Returns:
以ISO8601格式表示此日期的字符串。