intersection(with:)

func intersection(with dateInterval: DateInterval) -> DateInterval?

Return Value 戻り値

A date interval for the intersection of the receiver and dateInterval, or nil if no intersection occurs. レシーバとdateIntervalの交差の日付間隔、または交差が発生しないならばnil。

Discussion 議論

Calculating the intersection of date intervals is a commutative and associative operation. The intersection of a date interval with itself is equal to itself. 日付間隔の交差の計算は、可換および連想の演算です。ある日付間隔とそれ自身の交差は、それ自身と等しいです。

The following figure illustrates five NSDateInterval objects plotted on an arbitrary time axis. Each date interval spans its duration from left to right, from its startDate to its endDate. 以下の図は、ある随意の時間軸上の５つのNSDateIntervalオブジェクトを図示します。それぞれの日付間隔は、左から右へそれのdurationにまたがります、それのstartDateからそれのendDateまで。

The date intervals labeled A and B do not intersect, because the startDate of B occurs later than the endDate of A. ラベルAとBの日付間隔は交差しません、なぜならBのstartDateはAのendDateより後に現れるからです。

The date intervals labeled C and D do intersect. The date interval labeled E represents the result of calculating the intersection between C and D. ラベルEの日付間隔は、CとDの間の交差を計算する結果を表します。