compare(_:)

func compare(_ dateInterval: DateInterval) -> ComparisonResult

Return Value 戻り値

Returns an ComparisonResult value that indicates the temporal ordering of the receiver and a given date interval: あるComparisonResult値を返します、それはレシーバとある与えられた日付間隔の時間的順序を指し示します。

• ComparisonResult.orderedAscending if the receiver’s startDate occurs earlier than that of dateInterval, or both startDate values are equal and the duration of the receiver is less than that of dateInterval. ComparisonResult.orderedAscending、もしレシーバのstartDateがdateIntervalのそれより早く現れるならば、または両方のstartDate値が等しくそしてレシーバのdurationがdateIntervalのそれより少ないならば。

• ComparisonResult.orderedDescending if the receiver’s startDate occurs later than that of dateInterval, or both startDate values are equal and the duration of the receiver is greater than that of dateInterval. ComparisonResult.orderedDescending、もしレシーバのstartDateがdateIntervalのそれより後に現れるならば、または両方のstartDate値が等しくそしてレシーバのdurationがdateIntervalのそれより大きいならば。

• ComparisonResult.orderedSame if the receiver’s startDate and duration values are equal to those of dateInterval. ComparisonResult.orderedSame、もしレシーバのstartDateとduration値がdateIntervalのそれらと等しいならば。

Discussion 議論

The following figure illustrates four 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 result of comparing the date interval labeled A with the date interval labeled B is ComparisonResult.orderedAscending, because A has a startDate that occurs earlier than that of B. ラベルAの日付間隔とラベルBの日付間隔との比較の結果はComparisonResult.orderedAscendingです、なぜならAのstartDateはBのそれより早く現れるからです。

The result of comparing the date interval labeled C with the date interval labeled D is ComparisonResult.orderedDescending, because because C and D have the same startDate, and C has a duration greater than that of D. ラベルCの日付間隔とラベルDの日付間隔との比較の結果はComparisonResult.orderedDescendingです、なぜならCとDは同じstartDateを持ち、そしてCのdurationはDのそれより大きいからです。