麻辣GIS微信平台

更多 GIS 干货

微信关注不错过

Cesium API - JulianDate 中文文档

本文介绍下Cesium中 JulianDate API的详细使用说明。

JulianDate API 调用方法

new Cesium.JulianDate(julianDayNumber, secondsOfDay, timeStandard)
代表一个天文学的儒略日期,它是自-4712年1月1日(公元前4713年)正午以来的天数。 为了提高精度, 这个类将日期的整数部分和日期的秒部分存储在不同的组件中。 为了计算和表示闰秒的安全, 日期总是存储在国际原子时标准TimeStandard.TAI中。
Name Type Default Description
julianDayNumber Number 0.0 optional 儒略日数表示整天数。 小数天数也将被正确处理。
secondsOfDay Number 0.0 optional 当前儒略日数的秒数。 小数秒,负秒和大于一天的秒数将得到正确处理。
timeStandard TimeStandard TimeStandard.UTC optional 定义前两个参数的时间标准。

成员变量

staticCesium.JulianDate.leapSeconds : Array.<LeapSecond>
获取或设置在Cesium中使用的闰秒列表。
dayNumber : Number
Gets or sets the number of whole days.
secondsOfDay : Number
Gets or sets the number of seconds into the current day.

内置方法

staticCesium.JulianDate.addDays(julianDate, days, result)JulianDate
将提供的天数添加到提供的日期实例。
Name Type Description
julianDate JulianDate 日期。
days Number 要加或减的天数。
result JulianDate 要用于结果的现有实例。
返回值:
修改后的结果参数。
staticCesium.JulianDate.addHours(julianDate, hours, result)JulianDate
将提供的小时数添加到提供的日期实例。
Name Type Description
julianDate JulianDate 日期。
hours Number 要加或减的小时数。
result JulianDate 要用于结果的现有实例。
返回值:
修改后的结果参数。
staticCesium.JulianDate.addMinutes(julianDate, minutes, result)JulianDate
将提供的分钟数添加到提供的日期实例。
Name Type Description
julianDate JulianDate 日期。
minutes Number 要加或减的分钟数。
result JulianDate 要用于结果的现有实例。
返回值:
修改后的结果参数。
staticCesium.JulianDate.addSeconds(julianDate, seconds, result)JulianDate
将提供的秒数添加到提供的日期实例。
Name Type Description
julianDate JulianDate 日期。
seconds Number 要加或减的秒数。
result JulianDate 要用于结果的现有实例。
返回值:
修改后的结果参数。
staticCesium.JulianDate.clone(julianDate, result)JulianDate
复制一个JulianDate实例。
Name Type Description
julianDate JulianDate 要被复制的日期。
result JulianDate optional 要用于结果的现有实例。
返回值:
修改后的结果参数或新实例(如果没有提供)。 如果julianDate未定义,则返回undefined。
staticCesium.JulianDate.compare(left, right)Number
比较两个实例
Name Type Description
left JulianDate 第一个实例。
right JulianDate 第二个实例。
返回值:
如果左边小于右边,则为负值;如果左边大于右边,则为正值;如果左右相等,则为零。
staticCesium.JulianDate.computeTaiMinusUtc(julianDate)Number
计算提供的实例先于UTC的秒数。
Name Type Description
julianDate JulianDate 日期。
返回值:
提供的实例先于UTC的秒数
staticCesium.JulianDate.daysDifference(left, right)Number
计算所提供实例之间的天数差。
Name Type Description
left JulianDate 第一个实例。
right JulianDate 第二个实例。
返回值:
差值,以天为单位,将rightleft中减去。
staticCesium.JulianDate.equals(left, right)Boolean
比较两个实例,如果相等,则返回true,否则返回false
Name Type Description
left JulianDate optional 第一个实例。
right JulianDate optional 第二个实例。
返回值:
true如果日期相等;否则为false
staticCesium.JulianDate.equalsEpsilon(left, right, epsilon)Boolean
比较两个实例,如果它们在epsilon秒内,则返回true。 也就是说,为了使日期被认为是相等的(就是这个函数要返回true), 它们之间的差的绝对值(以秒为单位)必须小于epsilon
Name Type Description
left JulianDate optional 第一个实例。
right JulianDate optional 第二个实例。
epsilon Number 两个实例间的最大秒数。
返回值:
true如果两个日期在epsilon秒内;否则为false
staticCesium.JulianDate.fromDate(date, result)JulianDate
从一个JavaScript日期创建一个新实例。
Name Type Description
date Date 一个JavaScript 日期。
result JulianDate optional 要用于结果的现有实例。
返回值:
修改后的结果参数或新实例(如果没有提供)。
异常情况:
staticCesium.JulianDate.fromGregorianDate(date, result)JulianDate
从一个GregorianDate创建一个新实例。
Name Type Description
date GregorianDate 一个GregorianDate.
result JulianDate optional 要用于结果的现有实例。
返回值:
修改后的结果参数或新实例(如果没有提供)。
异常情况:
staticCesium.JulianDate.fromIso8601(iso8601String, result)JulianDate
从一个 ISO 8601日期创建一个新实例。 此方法优于 Date.parse,因为它将处理ISO 8601规范定义的所有有效格式, 包括闰秒和亚毫秒级时间,大多数JavaScript实现都废弃了这两个时间。
Name Type Description
iso8601String String 一个ISO 8601 日期。
result JulianDate optional 要用于结果的现有实例。
返回值:
修改后的结果参数或新实例(如果没有提供)。
异常情况:
staticCesium.JulianDate.greaterThan(left, right)Boolean
比较提供的实例,如果left晚于right,则返回true,否则返回 false
Name Type Description
left JulianDate 第一个实例。
right JulianDate 第二个实例。
返回值:
true 如果 left 晚于 right, 否则false
staticCesium.JulianDate.greaterThanOrEquals(left, right)Boolean
比较提供的实例,如果left晚于或等于right,则返回true,否则返回 false
Name Type Description
left JulianDate 第一个实例。
right JulianDate 第二个实例。
返回值:
true 如果 left 晚于或等于 right, 否则false
staticCesium.JulianDate.lessThan(left, right)Boolean
比较提供的实例,如果 left 早于 right ,则返回 true ,否则返回 false
Name Type Description
left JulianDate 第一个实例。
right JulianDate 第二个实例。
返回值:
true 如果 left 早于 right, 否则false
staticCesium.JulianDate.lessThanOrEquals(left, right)Boolean
比较提供的实例,如果 left 早于或等于 right ,则返回 true ,否则返回 false
Name Type Description
left JulianDate 第一个实例。
right JulianDate 第二个实例。
返回值:
true 如果 left 早于或等于 right, 否则false
staticCesium.JulianDate.now(result)JulianDate
创建一个代表当前系统时间的新实例。 这等效于调用JulianDate.fromDate(new Date());.
Name Type Description
result JulianDate optional 要用于结果的现有实例。
返回值:
修改后的结果参数或新实例(如果没有提供)。
staticCesium.JulianDate.secondsDifference(left, right)Number
计算提供的实例之间的秒差。
Name Type Description
left JulianDate 第一个实例。
right JulianDate 第二个实例。
返回值:
差值,以秒为单位,将rightleft中减去。
staticCesium.JulianDate.toDate(julianDate)Date
从提供的实例创建一个JavaScript Date。 由于JavaScript日期只能精确到最接近的毫秒,不能代表闰秒,因此可以考虑改用JulianDate.toGregorianDate。 如果提供的JulianDate在闰秒期间,则使用之前的秒。
Name Type Description
julianDate JulianDate 要转换的日期。
返回值:
代表提供的日期的新实例。
staticCesium.JulianDate.toGregorianDate(julianDate, result)GregorianDate
从提供的实例中创建一个GregorianDate
Name Type Description
julianDate JulianDate 要转换的日期。
result GregorianDate optional 要用于结果的现有实例。
返回值:
修改后的结果参数或新实例(如果没有提供)。
staticCesium.JulianDate.toIso8601(julianDate, precision)String
创建所提供日期的ISO8601表示形式。
Name Type Description
julianDate JulianDate 要转换的日期。
precision Number optional 用于表示秒分量的小数位数。 默认情况下,使用最精确的表示形式。
返回值:
所提供日期的ISO8601表示形式。
staticCesium.JulianDate.totalDays(julianDate)Number
计算提供的实例代表的整天和小数天的总数。
Name Type Description
julianDate JulianDate 日期。
返回值:
儒略日期作为单浮点数。
Duplicates this instance.
Name Type Description
result JulianDate optional An existing instance to use for the result.
返回值:
The modified result parameter or a new instance if none was provided.
equals(right)Boolean
Compares this and the provided instance and returns true if they are equal, false otherwise.
Name Type Description
right JulianDate optional The second instance.
返回值:
true if the dates are equal; otherwise, false.
equalsEpsilon(right, epsilon)Boolean
Compares this and the provided instance and returns true if they are within epsilon seconds of each other. That is, in order for the dates to be considered equal (and for this function to return true), the absolute value of the difference between them, in seconds, must be less than epsilon.
Name Type Description
right JulianDate optional The second instance.
epsilon Number The maximum number of seconds that should separate the two instances.
返回值:
true if the two dates are within epsilon seconds of each other; otherwise false.
toString()String
以ISO8601格式创建表示此日期的字符串。
返回值:
用ISO8601格式表示此日期的字符串。

其他API

Cesium中文API文档手册(v1.63.1版本)参考:《Cesium中文API文档手册(v1.63.1版本)

相关阅读

麻辣GIS-Sailor

作者:

GIS爱好者,学GIS,更爱玩GIS。

声明

1.本文所分享的所有需要用户下载使用的内容(包括但不限于软件、数据、图片)来自于网络或者麻辣GIS粉丝自行分享,版权归该下载资源的合法拥有者所有,如有侵权请第一时间联系本站删除。

2.下载内容仅限个人学习使用,请切勿用作商用等其他用途,否则后果自负。

手机阅读
公众号关注
知识星球
手机阅读
麻辣GIS微信公众号关注
最新GIS干货
关注麻辣GIS知识星球
私享圈子

留言板(小编看到第一时间回复)