TimeIntervalCollection

Members

readonlychangedEvent : Event

Core/TimeIntervalCollection.js 52

Gets an event that is raised whenever the collection of intervals change.

readonlyisEmpty : Boolean

Core/TimeIntervalCollection.js 130

Gets whether or not the collection is empty.

readonlyisStartIncluded : Boolean

Core/TimeIntervalCollection.js 77

Gets whether or not the start time is included in the collection.

readonlyisStopIncluded : Boolean

Core/TimeIntervalCollection.js 104

Gets whether or not the stop time is included in the collection.

readonlylength : Number

Core/TimeIntervalCollection.js 118

Gets the number of intervals in the collection.

readonlystart : JulianDate

Core/TimeIntervalCollection.js 64

Gets the start time of the collection.

readonlystop : JulianDate

Core/TimeIntervalCollection.js 90

Gets the stop time of the collection.

Methods

addInterval(interval, dataComparer)

Core/TimeIntervalCollection.js 303

Adds an interval to the collection, merging intervals that contain the same data and splitting intervals of different data as needed in order to maintain a non-overlapping collection. The data in the new interval takes precedence over any existing intervals in the collection.

Name	Type	Description
interval	TimeInterval	The interval to add.
dataComparer	TimeInterval~DataComparer	optional A function which compares the data of the two intervals. If omitted, reference equality is used.

contains(julianDate) → Boolean

Core/TimeIntervalCollection.js 220

Checks if the specified date is inside this collection.

Name	Type	Description
julianDate	JulianDate	The date to check.

Returns:

true if the collection contains the specified date, false otherwise.

equals(right, dataComparer) → Boolean

Core/TimeIntervalCollection.js 145

Compares this instance against the provided instance componentwise and returns true if they are equal, false otherwise.

Name	Type	Description
right	TimeIntervalCollection	optional The right hand side collection.
dataComparer	TimeInterval~DataComparer	optional A function which compares the data of the two intervals. If omitted, reference equality is used.

Returns:

true if they are equal, false otherwise.

findDataForIntervalContainingDate(date) → Object

Core/TimeIntervalCollection.js 209

Finds and returns the data for the interval that contains the specified date.

Name	Type	Description
date	JulianDate	The date to search for.

Returns:

The data for the interval containing the specified date, or undefined if no such interval exists.

findInterval(options) → TimeInterval

Core/TimeIntervalCollection.js 275

Returns the first interval in the collection that matches the specified parameters. All parameters are optional and undefined parameters are treated as a don't care condition.

Name	Type	Description
options	Object	optional Object with the following properties: Name Type Description start JulianDate optional The start time of the interval. stop JulianDate optional The stop time of the interval. isStartIncluded Boolean optional true if options.start is included in the interval, false otherwise. isStopIncluded Boolean optional true if options.stop is included in the interval, false otherwise.

Returns:

The first interval in the collection that matches the specified parameters.

findIntervalContainingDate(date) → TimeInterval|undefined

Core/TimeIntervalCollection.js 198

Finds and returns the interval that contains the specified date.

Name	Type	Description
date	JulianDate	The date to search for.

Returns:

The interval containing the specified date, undefined if no such interval exists.

get(index) → TimeInterval

Core/TimeIntervalCollection.js 172

Gets the interval at the specified index.

Name	Type	Description
index	Number	The index of the interval to retrieve.

Returns:

The interval at the specified index, or undefined if no interval exists as that index.

indexOf(date) → Number

Core/TimeIntervalCollection.js 235

Finds and returns the index of the interval in the collection that contains the specified date.

Name	Type	Description
date	JulianDate	The date to search for.

Returns:

The index of the interval that contains the specified date, if no such interval exists, it returns a negative number which is the bitwise complement of the index of the next interval that starts after the date, or if no interval starts after the specified date, the bitwise complement of the length of the collection.

intersect(other, dataComparer, mergeCallback) → TimeIntervalCollection

Core/TimeIntervalCollection.js 599

Creates a new instance that is the intersection of this collection and the provided collection.

Name	Type	Description
other	TimeIntervalCollection	The collection to intersect with.
dataComparer	TimeInterval~DataComparer	optional A function which compares the data of the two intervals. If omitted, reference equality is used.
mergeCallback	TimeInterval~MergeCallback	optional A function which merges the data of the two intervals. If omitted, the data from the left interval will be used.

Returns:

A new TimeIntervalCollection which is the intersection of this collection and the provided collection.

removeAll()

Core/TimeIntervalCollection.js 185

Removes all intervals from the collection.

removeInterval(interval)

Core/TimeIntervalCollection.js 453

Removes the specified interval from this interval collection, creating a hole over the specified interval. The data property of the input interval is ignored.

Name	Type	Description
interval	TimeInterval	The interval to remove.

Returns:

true if the interval was removed, false if no part of the interval was in the collection.