GregorianDate

GregorianDate 表示公历日期时间，以世界协调时间 (UTC) 为基础，是 CesiumJS 中的一个重要的时间类。

语法

new Cesium.GregorianDate(year, month, day, hour, minute, second, millisecond);

参数

• year <Number>: 年份 (必需)。
• month <Number>: 月份，范围从 1 到 12 (必需)。
• day <Number>: 日，范围从 1 到 31，具体取决于月份 (必需)。
• hour <Number>: 小时，范围从 0 到 23 (可选，默认值为 0)。
• minute <Number>: 分钟，范围从 0 到 59 (可选，默认值为 0)。
• second <Number>: 秒，范围从 0 到 59 (可选，默认值为 0)。
• millisecond <Number>: 毫秒，范围从 0 到 999 (可选，默认值为 0)。

示例

var gregorianDate = new Cesium.GregorianDate(2021, 9, 27, 12, 34, 56, 789);

属性

{Number} year

得到年份。

{Number} month

得到月份，范围从 1 到 12。

{Number} day

获取日，范围从 1 到 31，具体取决于月份。

{Number} hour

获取小时，范围从 0 到 23。

{Number} minute

获取分钟，范围从 0 到 59。

{Number} second

获取秒，范围从 0 到 59。

{Number} millisecond

获取毫秒，范围从 0 到 999。

方法

setTime(hour, minute, second, millisecond)

设置日期时间到指定时间。

参数

• {Number} hour：小时，范围从 0 到 23。
• {Number} minute：分钟，范围从 0 到 59。
• {Number} second：秒，范围从 0 到 59。
• {Number} millisecond：毫秒，范围从 0 到 999。

equals(right)

判断指定日期时间是否与本地日期时间相同。

参数

• {GregorianDate} right：与当前日期时间进行比较的日期时间。

返回值

• {Boolean}：等于返回 true，否则返回 false。

clone(result)

克隆当前日期时间并将其值设置为指定的结果。

参数

• {GregorianDate} result：此参数用于存储克隆日期时间，如果未传递值，则返回新的日期时间对象。

返回值

• {GregorianDate}：克隆的日期时间对象。

toDate()

返回当前日期时间的 JavaScript Date 实例。

返回值

• {Date}：JavaScript Date 实例。

示例

// 设置一个日期时间为 2021 年 9 月 27 日 12:34:56
var gregorianDate = new Cesium.GregorianDate(2021, 9, 27, 12, 34, 56);

// 克隆日期时间并增加一天
var tomorrow = gregorianDate.clone();
tomorrow.day++;

// 判断两个日期时间是否相等
var isEqual = gregorianDate.equals(tomorrow);

// 获取当前日期时间的 Date 对象
var jsDate = gregorianDate.toDate();

注意：月份是从 1 到 12，与 JavaScript Date 中的月份不同，由于历史原因 JavaScript Date 中的月份是从 0 到 11。因此，当使用 JavaScript Date 与 GregorianDate 进行比较时，月份应减去1。