JulianDate

表示天文儒略日，即自1月1日中午以來的天數(shù)，-4712（公元前4713年）。為了提高精度，此類將日期的整數(shù)部分和秒部分存儲(chǔ)在單獨(dú)的組件中。為了安全地進(jìn)行算術(shù)運(yùn)算并表示閏秒，日期總是存儲(chǔ)在國際原子時(shí)間標(biāo)準(zhǔn)TimeStandard.TAI中。

new JulianDate(julianDayNumber, secondsOfDay, timeStandard)

Parameters:

julianDayNumber (Number) (default 0.0) 儒略日數(shù)，表示整天的天數(shù)。分?jǐn)?shù)日也將得到正確處理。

secondsOfDay (Number) (default 0.0) 進(jìn)入當(dāng)前儒略日數(shù)的秒數(shù)。正確處理大于一天的小數(shù)秒、負(fù)秒和秒。

timeStandard (TimeStandard) (default TimeStandard.UTC) 定義前兩個(gè)參數(shù)的時(shí)間標(biāo)準(zhǔn)。

Members

(static) leapSeconds : Array.<LeapSecond>

獲取或設(shè)置在Bigemap GL中使用的閏秒列表。

dayNumber : Number

獲取或設(shè)置整天的天數(shù)。

secondsOfDay : Number

獲取或設(shè)置當(dāng)天的秒數(shù)。

Methods

(static) addDays(julianDate, days, result) → {JulianDate}

將提供的天數(shù)添加到提供的日期實(shí)例。

Parameters:

julianDate (JulianDate) 日期。

days (Number) 要加或減的天數(shù)。

result (JulianDate) 要用于結(jié)果的現(xiàn)有實(shí)例。

(static) addHours(julianDate, hours, result) → {JulianDate}

將提供的小時(shí)數(shù)添加到提供的日期實(shí)例。

Parameters:

julianDate (JulianDate) 日期。

hours (Number) 加或減的小時(shí)數(shù)。

result (JulianDate) 要用于結(jié)果的現(xiàn)有實(shí)例。

(static) addMinutes(julianDate, minutes, result) → {JulianDate}

將提供的分鐘數(shù)添加到提供的日期實(shí)例。

Parameters:

julianDate (JulianDate) 日期。

minutes (Number) 加或減的分鐘數(shù)。

result (JulianDate) 要用于結(jié)果的現(xiàn)有實(shí)例。

(static) addSeconds(julianDate, seconds, result) → {JulianDate}

向提供的日期實(shí)例添加提供的秒數(shù)。

Parameters:

julianDate (JulianDate) 日期。

seconds (Number) 加或減的秒數(shù)。

result (JulianDate) 要用于結(jié)果的現(xiàn)有實(shí)例。

(static) clone(julianDate, result) → {JulianDate}

復(fù)制Juliandate實(shí)例。

Parameters:

julianDate (JulianDate) 要復(fù)制的日期。

result (JulianDate) 要用于結(jié)果的現(xiàn)有實(shí)例。

(static) compare(left, right) → {Number}

比較兩個(gè)實(shí)例。

Parameters:

left (JulianDate) 第一個(gè)實(shí)例。

right (JulianDate) 第二個(gè)實(shí)例。

(static) computeTaiMinusUtc(julianDate) → {Number}

計(jì)算提供的實(shí)例早于UTC的秒數(shù)。

Parameters:

julianDate (JulianDate) 日期。

(static) daysDifference(left, right) → {Number}

計(jì)算所提供實(shí)例之間的天數(shù)差。

Parameters:

left (JulianDate) 第一個(gè)實(shí)例。

right (JulianDate) 第二個(gè)實(shí)例。

(static) equals(left, right) → {Boolean}

比較兩個(gè)實(shí)例，如果它們相等，則返回true，否則返回false。

Parameters:

left (JulianDate) 第一個(gè)實(shí)例。

right (JulianDate) 第二個(gè)實(shí)例。

(static) equalsEpsilon(left, right, epsilon) → {Boolean}

比較兩個(gè)實(shí)例并返回true如果它們彼此在epsilon秒內(nèi)。也就是說，為了將日期視為相等（并且此函數(shù)返回true），它們之間的差的絕對(duì)值（以秒為單位）必須小于epsilon。

Parameters:

left (JulianDate) 第一個(gè)實(shí)例。

right (JulianDate) 第二個(gè)實(shí)例。

epsilon (Number) 分隔兩個(gè)實(shí)例的最大秒數(shù)。

(static) fromDate(date, result) → {JulianDate}

從javascript日期創(chuàng)建新實(shí)例。

Parameters:

date (Date) 一個(gè)javascript日期。

result (JulianDate) 要用于結(jié)果的現(xiàn)有實(shí)例。

Throws

DeveloperError : 日期必須是有效的javascript日期。

(static) fromGregorianDate(date, result) → {JulianDate}

從公歷創(chuàng)建新實(shí)例。

Parameters:

date (GregorianDate) 公歷

result (JulianDate) 要用于結(jié)果的現(xiàn)有實(shí)例。

Throws

DeveloperError : 日期必須是有效的公歷日期。

(static) fromIso8601(iso8601String, result) → {JulianDate}

從ISO 8601日期創(chuàng)建新實(shí)例。此方法優(yōu)于Date.parse，因?yàn)樗鼘⑻幚碛蒊SO 8601規(guī)范定義的所有有效格式，包括大多數(shù)JavaScript實(shí)現(xiàn)所丟棄的閏秒和亞毫秒。

Parameters:

iso8601String (String) ISO 8601日期。

result (JulianDate) 要用于結(jié)果的現(xiàn)有實(shí)例。

Throws

DeveloperError : 無效的ISO 8601日期。

(static) greaterThan(left, right) → {Boolean}

比較提供的實(shí)例，如果left晚于right，false，則返回true。

Parameters:

left (JulianDate) 第一個(gè)實(shí)例。

right (JulianDate) 第二個(gè)實(shí)例。

(static) greaterThanOrEquals(left, right) → {Boolean}

比較提供的實(shí)例，如果left晚于或等于right，false，則返回true。

Parameters:

left (JulianDate) 第一個(gè)實(shí)例。

right (JulianDate) 第二個(gè)實(shí)例。

(static) lessThan(left, right) → {Boolean}

比較提供的實(shí)例，如果left早于right，false，則返回true。

Parameters:

left (JulianDate) 第一個(gè)實(shí)例。

right (JulianDate) 第二個(gè)實(shí)例。

(static) lessThanOrEquals(left, right) → {Boolean}

比較提供的實(shí)例，如果left早于或等于right，false，則返回true，否則返回。

Parameters:

left (JulianDate) 第一個(gè)實(shí)例。

right (JulianDate) 第二個(gè)實(shí)例。

(static) now(result) → {JulianDate}

創(chuàng)建表示當(dāng)前系統(tǒng)時(shí)間的新實(shí)例。這相當(dāng)于呼叫JulianDate.fromDate(new Date());。

Parameters:

result (JulianDate) 要用于結(jié)果的現(xiàn)有實(shí)例。

(static) secondsDifference(left, right) → {Number}

計(jì)算所提供實(shí)例之間的秒數(shù)差。

Parameters:

left (JulianDate) 第一個(gè)實(shí)例。

right (JulianDate) 第二個(gè)實(shí)例。

(static) toDate(julianDate) → {Date}

從提供的實(shí)例創(chuàng)建javascript日期。由于javascript日期僅精確到最接近的毫秒，不能表示閏秒，請(qǐng)考慮改用JulianDate.toGregorianDate。如果提供的juliandate在閏秒期間，則使用前一秒。

Parameters:

julianDate (JulianDate) 要轉(zhuǎn)換的日期。

(static) toGregorianDate(julianDate, result) → {GregorianDate}

從提供的實(shí)例創(chuàng)建GregorianDate。

Parameters:

julianDate (JulianDate) 要轉(zhuǎn)換的日期。

result (GregorianDate) 要用于結(jié)果的現(xiàn)有實(shí)例。

(static) toIso8601(julianDate, precision) → {String}

創(chuàng)建所提供日期的ISO8601表示形式。

Parameters:

julianDate (JulianDate) 要轉(zhuǎn)換的日期。

precision (Number) 用于表示秒分量的小數(shù)位數(shù)。默認(rèn)情況下，使用最精確的表示。

(static) totalDays(julianDate) → {Number}

計(jì)算由提供的實(shí)例表示的完整和小數(shù)天的總數(shù)。

Parameters:

julianDate (JulianDate) 日期。

clone(result) → {JulianDate}

復(fù)制此實(shí)例。

Parameters:

result (JulianDate) 要用于結(jié)果的現(xiàn)有實(shí)例。

equals(right) → {Boolean}

將此實(shí)例與提供的實(shí)例進(jìn)行比較，如果它們相等，則返回true，否則返回false。

Parameters:

right (JulianDate) 第二個(gè)實(shí)例。

equalsEpsilon(right, epsilon) → {Boolean}

將此實(shí)例與提供的實(shí)例進(jìn)行比較，并返回true如果它們彼此在epsilon秒內(nèi)。也就是說，為了將日期視為相等（并且此函數(shù)返回true），它們之間的差的絕對(duì)值（以秒為單位）必須小于epsilon。

Parameters:

right (JulianDate) 第二個(gè)實(shí)例。

epsilon (Number) 分隔兩個(gè)實(shí)例的最大秒數(shù)。

toString() → {String}

以ISO8601格式創(chuàng)建表示此日期的字符串。