JulianDate

Represents an astronomical Julian date, which is the number of days since noon on January 1, -4712 (4713 BC). For increased precision, this class stores the whole number part of the date and the seconds part of the date in separate components. In order to be safe for arithmetic and represent leap seconds, the date is always stored in the International Atomic Time standard TimeStandard.TAI.

new Cesium.JulianDate(julianDayNumber, secondsOfDay, timeStandard)
engine/Source/Core/JulianDate.js 199

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>
engine/Source/Core/JulianDate.js 1201

获取或设置整个 Cesium 中使用的闰秒列表。

dayNumber : number
engine/Source/Core/JulianDate.js 210

获取或设置整天的数目。

secondsOfDay : number
engine/Source/Core/JulianDate.js 216

获取或设置当前这一天中的秒数。

Methods

static Cesium.JulianDate.addDays(julianDate, days, result) → JulianDate
engine/Source/Core/JulianDate.js 1089

将所提供的天数加到所提供的日期实例上。
Name Type Description
julianDate JulianDate 日期。
days number 要增加或减去的天数。
result JulianDate 用于存放结果的现有实例。
Returns:
修改后的结果参数。

static Cesium.JulianDate.addHours(julianDate, hours, result) → JulianDate
engine/Source/Core/JulianDate.js 1063

将所提供的小时数加到所提供的日期实例上。
Name Type Description
julianDate JulianDate 日期。
hours number 要增加或减去的小时数。
result JulianDate 用于存放结果的现有实例。
Returns:
修改后的结果参数。

static Cesium.JulianDate.addMinutes(julianDate, minutes, result) → JulianDate
engine/Source/Core/JulianDate.js 1037

将所提供的分钟数加到所提供的日期实例上。
Name Type Description
julianDate JulianDate 日期。
minutes number 要增加或减去的分钟数。
result JulianDate 用于存放结果的现有实例。
Returns:
修改后的结果参数。

static Cesium.JulianDate.addSeconds(julianDate, seconds, result) → JulianDate
engine/Source/Core/JulianDate.js 1009

将所提供的秒数加到所提供的日期实例上。
Name Type Description
julianDate JulianDate 日期。
seconds number 要增加或减去的秒数。
result JulianDate 用于存放结果的现有实例。
Returns:
修改后的结果参数。

static Cesium.JulianDate.clone(julianDate, result) → JulianDate
engine/Source/Core/JulianDate.js 835

复制一个 JulianDate 实例。
Name Type Description
julianDate JulianDate 要复制的日期。
result JulianDate optional 用于存放结果的现有实例。
Returns:
修改后的结果参数，如果未提供则为新实例；如果 julianDate 为 undefined，则返回 undefined。

static Cesium.JulianDate.compare(left, right) → number
engine/Source/Core/JulianDate.js 858

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

static Cesium.JulianDate.computeTaiMinusUtc(julianDate) → number
engine/Source/Core/JulianDate.js 983

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

static Cesium.JulianDate.daysDifference(left, right) → number
engine/Source/Core/JulianDate.js 961

计算所提供的实例之间相差的天数。
Name Type Description
left JulianDate 第一个实例。
right JulianDate 第二个实例。
Returns:
从 left 减去 right 所得到的天数差。

static Cesium.JulianDate.equals(left, right) → boolean
engine/Source/Core/JulianDate.js 882

比较两个实例，如果它们相等则返回 true，否则返回 false。
Name Type Description
left JulianDate optional 第一个实例。
right JulianDate optional 第二个实例。
Returns:
true 如果日期相等；否则为 false。

static Cesium.JulianDate.equalsEpsilon(left, right, epsilon) → boolean
engine/Source/Core/JulianDate.js 903

比较两个实例，如果它们在 epsilon 秒之内，则返回 true。 也就是说，要使日期被视为相等（并使此函数返回 true），它们之间相差的绝对值（以秒计）必须小于 epsilon。
Name Type Default Description
left JulianDate optional 第一个实例。
right JulianDate optional 第二个实例。
epsilon number 0 optional 应当分隔两个实例的最大秒数。
Returns:
true 如果两个日期在 epsilon 秒之内；否则为 false。

static Cesium.JulianDate.fromDate(date, result) → JulianDate
engine/Source/Core/JulianDate.js 277

从一个 JavaScript Date 创建一个新的实例。
Name Type Description
date Date 一个 JavaScript Date。
result JulianDate optional 用于存放结果的现有实例。
Returns:
修改后的结果参数，如果未提供则为新实例。
Throws:

static Cesium.JulianDate.fromGregorianDate(date, result) → JulianDate
engine/Source/Core/JulianDate.js 244

从一个 GregorianDate 创建一个新的实例。
Name Type Description
date GregorianDate 一个 GregorianDate。
result JulianDate optional 用于存放结果的现有实例。
Returns:
修改后的结果参数，如果未提供则为新实例。
Throws:

static Cesium.JulianDate.fromIso8601(iso8601String, result) → JulianDate
engine/Source/Core/JulianDate.js 312

从一个 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
engine/Source/Core/JulianDate.js 1135

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

static Cesium.JulianDate.greaterThanOrEquals(left, right) → boolean
engine/Source/Core/JulianDate.js 1146

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

static Cesium.JulianDate.lessThan(left, right) → boolean
engine/Source/Core/JulianDate.js 1113

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

static Cesium.JulianDate.lessThanOrEquals(left, right) → boolean
engine/Source/Core/JulianDate.js 1124

比较所提供的实例，如果 left 早于或等于 right 则返回 true，否则返回 false。
Name Type Description
left JulianDate 第一个实例。
right JulianDate 第二个实例。
Returns:
true 如果 left 早于或等于 right；否则为 false。

static Cesium.JulianDate.now(result) → JulianDate
engine/Source/Core/JulianDate.js 615

创建一个表示当前系统时间的新实例。 这等价于调用 JulianDate.fromDate(new Date());。
Name Type Description
result JulianDate optional 用于存放结果的现有实例。
Returns:
修改后的结果参数，如果未提供则为新实例。

static Cesium.JulianDate.secondsDifference(left, right) → number
engine/Source/Core/JulianDate.js 939

计算所提供的实例之间相差的秒数。
Name Type Description
left JulianDate 第一个实例。
right JulianDate 第二个实例。
Returns:
从 left 减去 right 所得到的秒数差。

static Cesium.JulianDate.toDate(julianDate) → Date
engine/Source/Core/JulianDate.js 717

从所提供的实例创建一个 JavaScript Date。 由于 JavaScript 日期的精度仅到最接近的毫秒，并且无法表示闰秒，因此请考虑改用 JulianDate.toGregorianDate。 如果所提供的 JulianDate 处于闰秒期间，则使用前一秒。
Name Type Description
julianDate JulianDate 要转换的日期。
Returns:
表示所提供日期的新实例。

static Cesium.JulianDate.toGregorianDate(julianDate, result) → GregorianDate
engine/Source/Core/JulianDate.js 626

从所提供的实例创建一个 GregorianDate。
Name Type Description
julianDate JulianDate 要转换的日期。
result GregorianDate optional 用于存放结果的现有实例。
Returns:
修改后的结果参数，如果未提供则为新实例。

static Cesium.JulianDate.toIso8601(julianDate, precision) → string
engine/Source/Core/JulianDate.js 749

创建所提供日期的 ISO8601 表示。
Name Type Description
julianDate JulianDate 要转换的日期。
precision number optional 用于表示秒数部分的分数位数。默认使用最精确的表示。
Returns:
所提供日期的 ISO8601 表示。

static Cesium.JulianDate.totalDays(julianDate) → number
engine/Source/Core/JulianDate.js 920

计算所提供的实例所表示的整天数与小数天数之和。
Name Type Description
julianDate JulianDate 日期。
Returns:
以单个浮点数表示的儒略日期。

clone(result) → JulianDate
engine/Source/Core/JulianDate.js 1156

复制此实例。
Name Type Description
result JulianDate optional 用于存放结果的现有实例。
Returns:
修改后的结果参数，如果未提供则为新实例。

equals(right) → boolean
engine/Source/Core/JulianDate.js 1166

比较此实例与所提供的实例，如果它们相等则返回 true，否则返回 false。
Name Type Description
right JulianDate optional 第二个实例。
Returns:
true 如果日期相等；否则为 false。

equalsEpsilon(right, epsilon) → boolean
engine/Source/Core/JulianDate.js 1180

比较此实例与所提供的实例，如果它们在 epsilon 秒之内，则返回 true。 也就是说，要使日期被视为相等（并使此函数返回 true），它们之间相差的绝对值（以秒计）必须小于 epsilon。
Name Type Default Description
right JulianDate optional 第二个实例。
epsilon number 0 optional 应当分隔两个实例的最大秒数。
Returns:
true 如果两个日期在 epsilon 秒之内；否则为 false。

toString() → string
engine/Source/Core/JulianDate.js 1189

创建一个以 ISO8601 格式表示此日期的字符串。
Returns:
以 ISO8601 格式表示此日期的字符串。
需要帮助？获取答案的最快方式是在 Cesium 论坛 上向社区和团队提问。
CtrlK
packages/engine
packages/widgets