JulianDate

new Cesium.JulianDate ( julianDayNumber , secondsOfDay , timeStandard )

表示天文儒略日期,即自 -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 中使用的闰秒列表。

dayNumber : Number

获取或设置天数。

secondsOfDay : Number

获取或设置到当前日期的秒数。

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。

static Cesium.JulianDate.compare (left, right) Number

比较两个实例。
Name Type Description
left JulianDate 第一个实例。
right JulianDate 第二种情况。
Returns:
如果left小于right,则为负值,如果left大于right,则为正值,如果left和right相等,则为零。

static Cesium.JulianDate.computeTaiMinusUtc (julianDate) Number

计算提供的实例领先于 UTC 的秒数。
Name Type Description
julianDate JulianDate 日期。
Returns:
提供的实例领先于 UTC 的秒数

static Cesium.JulianDate.daysDifference (left, right) Number

计算提供的实例之间的天数差异。
Name Type Description
left JulianDate 第一个实例。
right JulianDate 第二种情况。
Returns:
left 减去 right 时的差异,以天为单位。

static Cesium.JulianDate.equals ( left , right ) Boolean

比较两个实例,如果相等则返回 true ,否则返回 false
Name Type Description
left JulianDate 可选 第一个实例。
right JulianDate 可选 第二个实例。
Returns:
如果日期相等,则为 true ;否则, false

static Cesium.JulianDate.equalsEpsilon ( left , right , epsilon ) Boolean

比较两个实例,如果它们在 epsilon 秒内,则返回 true 。也就是说,为了使日期被视为相等(并且此函数返回 true ),它们之间的差异的绝对值(以秒为单位)必须小于 epsilon
Name Type Default Description
left JulianDate 可选 第一个实例。
right JulianDate 可选 第二个实例。
epsilon Number 0 可选 应该分隔两个实例的最大秒数。
Returns:
如果两个日期在 epsilon 秒内,则为 true ;否则 false

static Cesium.JulianDate.fromDate (date, result ) JulianDate

从 JavaScript 日期创建一个新实例。
Name Type Description
date Date JavaScript 日期。
result JulianDate 可选 用于结果的现有实例。
Returns:
修改后的结果参数或新实例(如果没有提供)。
Throws:

static Cesium.JulianDate.fromGregorianDate (date, result ) JulianDate

从 GregorianDate 创建一个新实例。
Name Type Description
date GregorianDate 一个公历日期。
result JulianDate 可选 用于结果的现有实例。
Returns:
修改后的结果参数或新实例(如果没有提供)。
Throws:

static Cesium.JulianDate.fromIso8601 (iso8601String, result ) JulianDate

ISO 8601 日期创建一个新实例。此方法优于 Date.parse ,因为它将处理 ISO 8601 规范定义的所有有效格式,包括闰秒和亚毫秒时间,大多数 JavaScript 实现都丢弃了这些格式。
Name Type Description
iso8601String String ISO 8601 日期。
result JulianDate 可选 用于结果的现有实例。
Returns:
修改后的结果参数或新实例(如果没有提供)。
Throws:

static Cesium.JulianDate.greaterThan (left, right) Boolean

比较提供的实例,如果 left 晚于 right 则返回 true ,否则返回 false
Name Type Description
left JulianDate 第一个实例。
right JulianDate 第二种情况。
Returns:
如果 left 晚于 right 则为 true ,否则为 false

static Cesium.JulianDate.greaterThanOrEquals (left, right) Boolean

比较提供的实例,如果 left 晚于或等于 right 则返回 true ,否则返回 false
Name Type Description
left JulianDate 第一个实例。
right JulianDate 第二种情况。
Returns:
如果 left 晚于或等于 right ,则为 true ,否则为 false

static Cesium.JulianDate.lessThan (left, right) Boolean

比较提供的实例,如果 left 早于 right 则返回 true ,否则返回 false
Name Type Description
left JulianDate 第一个实例。
right JulianDate 第二种情况。
Returns:
如果 left 早于 right ,则为 true ,否则为 false

static Cesium.JulianDate.lessThanOrEquals (left, right) Boolean

比较提供的实例,如果 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 可选 用于结果的现有实例。
Returns:
修改后的结果参数或新实例(如果没有提供)。

static Cesium.JulianDate.secondsDifference (left, right) Number

计算提供的实例之间的秒数差异。
Name Type Description
left JulianDate 第一个实例。
right JulianDate 第二种情况。
Returns:
left 减去 right 时的差异,以秒为单位。

static Cesium.JulianDate.toDate (julianDate) Date

从提供的实例创建一个 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 可选 用于结果的现有实例。
Returns:
修改后的结果参数或新实例(如果没有提供)。

static Cesium.JulianDate.toIso8601 (julianDate, precision ) String

创建所提供日期的 ISO8601 表示。
Name Type Description
julianDate JulianDate 要转换的日期。
precision Number 可选 用于表示秒组件的小数位数。默认情况下,使用最精确的表示。
Returns:
提供日期的 ISO8601 表示。

static Cesium.JulianDate.totalDays (julianDate) Number

计算由提供的实例表示的整数天和小数天的总数。
Name Type Description
julianDate JulianDate 日期。
Returns:
儒略日期为单浮点数。
复制此实例。
Name Type Description
result JulianDate 可选 用于结果的现有实例。
Returns:
修改后的结果参数或新实例(如果没有提供)。

equals ( right ) Boolean

比较 this 和提供的实例,如果相等则返回 true ,否则返回 false
Name Type Description
right JulianDate 可选 第二个实例。
Returns:
如果日期相等,则为 true ;否则, false

equalsEpsilon ( right , epsilon ) Boolean

比较这个和提供的实例,如果它们在 epsilon 秒内,则返回 true 。也就是说,为了使日期被视为相等(并且此函数返回 true ),它们之间的差异的绝对值(以秒为单位)必须小于 epsilon
Name Type Default Description
right JulianDate 可选 第二个实例。
epsilon Number 0 可选 应该分隔两个实例的最大秒数。
Returns:
如果两个日期在 epsilon 秒内,则为 true ;否则 false

toString () String

创建一个以 ISO8601 格式表示此日期的字符串。
Returns:
以 ISO8601 格式表示此日期的字符串。