TimeIntervalCollection

按開始時間排序的TimeInterval實例的非重疊集合。

new TimeIntervalCollection(intervals)

Parameters:

intervals (Array.<TimeInterval>) 要添加到集合中的間隔數組。

Members

(readonly) changedEvent : Event

獲取在間隔集合更改時引發的事件。

(readonly) isEmpty : Boolean

獲取集合是否為空。

(readonly) isStartIncluded : Boolean

獲取集合中是否包含開始時間。

(readonly) isStopIncluded : Boolean

獲取集合中是否包含停止時間。

(readonly) length : Number

獲取集合中的間隔數。

(readonly) start : JulianDate

獲取集合的開始時間。

(readonly) stop : JulianDate

獲取集合的停止時間。

Methods

(static) fromIso8601(options, result) → {TimeIntervalCollection}

從ISO 8601時間間隔（開始/結束/持續時間）創建新實例。

Parameters:

options (Object)

Name	Description
options.iso8601 `String`	ISO 8601間隔。
options.isStartIncluded `Boolean` default `true`	`true`如果間隔中包含開始時間，`false`否則。
options.isStopIncluded `Boolean` default `true`	`true`如果間隔中包含停止時間，則`false`否則。
options.leadingInterval `Boolean` default `false`	`true`如果要添加從iso8601.minimum_值到開始時間的間隔，`false`否則。
options.trailingInterval `Boolean` default `false`	`true`如果要將停止時間間隔添加到iso8601.maximum{value，則`false`否則。
options.dataCallback `function`	一個函數，它將返回在添加到集合之前用每個間隔調用的數據。如果未指定，則數據將是集合中的索引。

result (TimeIntervalCollection) 要用于結果的現有實例。

(static) fromIso8601DateArray(options, result) → {TimeIntervalCollection}

從ISO 8601日期數組創建新實例。

Parameters:

options (Object)

Name	Description
options.iso8601Dates `Array.<String>`	ISO 8601日期數組。
options.isStartIncluded `Boolean` default `true`	`true`如果間隔中包含開始時間，`false`否則。
options.isStopIncluded `Boolean` default `true`	`true`如果間隔中包含停止時間，則`false`否則。
options.leadingInterval `Boolean` default `false`	`true`如果要添加從iso8601.minimum_值到開始時間的間隔，`false`否則。
options.trailingInterval `Boolean` default `false`	`true`如果要將停止時間間隔添加到iso8601.maximum{value，則`false`否則。
options.dataCallback `function`	一個函數，它將返回在添加到集合之前用每個間隔調用的數據。如果未指定，則數據將是集合中的索引。

result (TimeIntervalCollection) 要用于結果的現有實例。

(static) fromIso8601DurationArray(options, result) → {TimeIntervalCollection}

從ISO 8601持續時間數組創建新實例。

Parameters:

options (Object)

Name	Description
options.epoch `JulianDate`	持續時間相對于的日期。
options.iso8601Durations `String`	ISO 8601持續時間的數組。
options.relativeToPrevious `Boolean` default `false`	`true`如果持續時間相對于前一個日期，`false`如果總是相對于時代。
options.isStartIncluded `Boolean` default `true`	`true`如果間隔中包含開始時間，`false`否則。
options.isStopIncluded `Boolean` default `true`	`true`如果間隔中包含停止時間，則`false`否則。
options.leadingInterval `Boolean` default `false`	`true`如果要添加從iso8601.minimum_值到開始時間的間隔，`false`否則。
options.trailingInterval `Boolean` default `false`	`true`如果要將停止時間間隔添加到iso8601.maximum{value，則`false`否則。
options.dataCallback `function`	一個函數，它將返回在添加到集合之前用每個間隔調用的數據。如果未指定，則數據將是集合中的索引。

result (TimeIntervalCollection) 要用于結果的現有實例。

(static) fromJulianDateArray(options, result) → {TimeIntervalCollection}

從Juliandate數組創建新實例。

Parameters:

options (Object)

Name	Description
options.julianDates `Array.<JulianDate>`	ISO 8601日期數組。
options.isStartIncluded `Boolean` default `true`	`true`如果間隔中包含開始時間，`false`否則。
options.isStopIncluded `Boolean` default `true`	`true`如果間隔中包含停止時間，則`false`否則。
options.leadingInterval `Boolean` default `false`	`true`如果要添加從iso8601.minimum_值到開始時間的間隔，`false`否則。
options.trailingInterval `Boolean` default `false`	`true`如果要將停止時間間隔添加到iso8601.maximum{value，則`false`否則。
options.dataCallback `function`	一個函數，它將返回在添加到集合之前用每個間隔調用的數據。如果未指定，則數據將是集合中的索引。

result (TimeIntervalCollection) 要用于結果的現有實例。

addInterval(interval, dataComparer)

向集合中添加間隔，合并包含相同數據的間隔，并根據需要拆分不同數據的間隔，以維護不重疊的集合。新間隔中的數據優先于集合中的任何現有間隔。

Parameters:

interval (TimeInterval) 要添加的間隔。

dataComparer (TimeInterval~DataComparer) 比較兩個間隔的數據的函數。如果省略，則使用引用等式。

contains(julianDate) → {Boolean}

檢查指定的日期是否在此集合中。

Parameters:

julianDate (JulianDate) 要檢查的日期。

equals(right, dataComparer) → {Boolean}

將此實例與提供的實例組件進行比較，如果相等，則返回true，否則返回false。

Parameters:

right (TimeIntervalCollection) 右側收藏。

dataComparer (TimeInterval~DataComparer) 比較兩個間隔的數據的函數。如果省略，則使用引用等式。

findDataForIntervalContainingDate(date) → {Object}

查找并返回包含指定日期的間隔的數據。

Parameters:

date (JulianDate) 要搜索的日期。

findInterval(options) → {TimeInterval}

返回集合中與指定參數匹配的第一個間隔。所有參數都是可選的，undefined參數被視為“不關心”條件。

Parameters:

options (Object)

Name	Description
options.start `JulianDate`	間隔的開始時間。
options.stop `JulianDate`	間隔的停止時間。
options.isStartIncluded `Boolean`	`true`如果間隔中包含`options.start`，則`false`否則。
options.isStopIncluded `Boolean`	`true`如果間隔中包含`options.stop`，則`false`否則。

findIntervalContainingDate(date) → {TimeInterval|undefined}

查找并返回包含指定日期的間隔。

Parameters:

date (JulianDate) 要搜索的日期。

get(index) → {TimeInterval}

獲取指定索引處的間隔。

Parameters:

index (Number) 要檢索的間隔的索引。

indexOf(date) → {Number}

查找并返回集合中包含指定日期的間隔的索引。

Parameters:

date (JulianDate) 要搜索的日期。

intersect(other, dataComparer, mergeCallback) → {TimeIntervalCollection}

創建一個新實例，該實例是此集合與提供的集合的交集。

Parameters:

other (TimeIntervalCollection) 要與之相交的集合。

dataComparer (TimeInterval~DataComparer) 比較兩個間隔的數據的函數。如果省略，則使用引用等式。

mergeCallback (TimeInterval~MergeCallback) 合并兩個區間的數據的函數。如果省略，將使用左間隔中的數據。

removeAll()

從集合中刪除所有間隔。

removeInterval(interval) → {Boolean}

從該間隔集合中刪除指定間隔，在指定間隔上創建一個孔。輸入間隔的數據屬性被忽略。

Parameters:

interval (TimeInterval) 要刪除的間隔。