JulianDate

new Cesium.JulianDate(julianDayNumber, secondsOfDay, timeStandard)

表示天文学的儒略日期,即自公元前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 中使用的闰秒列表。
获取或设置完整天数。

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 optional 用于结果的现有实例。
Returns:
修改后的结果参数,如果未提供则返回一个新实例。如果 julianDate 是 undefined,返回 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 optional 第一个实例。
right JulianDate optional 第二个实例。
Returns:
如果日期相等,则返回 true;否则返回 false

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

比较两个实例并返回 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:

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

从 GregorianDate 创建一个新实例。
Name Type Description
date GregorianDate 一个 GregorianDate。
result JulianDate optional 要用于结果的现有实例。
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 optional 要用于结果的现有实例。
Returns:
修改后的结果参数,如果未提供则返回一个新实例。
Throws:

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

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

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

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

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

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

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

比较提供的实例,并返回 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:
修改后的结果参数,如果未提供则返回一个新实例。

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

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

static Cesium.JulianDate.toDate(julianDate)Date

从提供的实例创建一个 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:
修改后的结果参数,如果未提供则返回一个新实例。

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

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

static Cesium.JulianDate.totalDays(julianDate)number

计算由提供的实例表示的完整和分数天总数。
Name Type Description
julianDate JulianDate 日期。
Returns:
作为单个浮点数的儒略日期。
复制此实例。
Name Type Description
result JulianDate optional 要用于结果的现有实例。
Returns:
修改后的结果参数,如果未提供则返回一个新实例。

equals(right)boolean

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

equalsEpsilon(right, epsilon)boolean

比较此实例和提供的实例,并返回 true 如果它们之间的差值在 epsilon 秒以内。 也就是说,要认为日期相等(并且此函数返回 true), 它们之间的绝对差值(以秒为单位)必须小于 epsilon
Name Type Default Description
right JulianDate optional 第二个实例。
epsilon number 0 optional 应该使两个实例分开的最大秒数。
Returns:
如果两个日期相差在 epsilon 秒以内,则返回 true;否则返回 false
创建一个字符串,表示此日期的 ISO8601 格式。
Returns:
一个表示此日期的 ISO8601 格式的字符串。
需要帮助?获得答案的最快方法是来自社区和团队 Cesium Forum.