インスタンスメソッド

dateComponents(_:from:to:)

DateComponents として指定された 2 つの日付の差を返します。

iOS 8.0+ iPadOS 8.0+ Mac Catalyst 13.0+ macOS 10.10+

tvOS 9.0+ VisionOS 1.0+ WatchOS 2.0+ Xcode 6.0.1+

func dateComponents(

_ components: Set<Calendar.Component>,

from start: DateComponents,

to end: DateComponents

) -> DateComponents

パラメータ

components

比較すべきコンポーネント。

start

開始する日付コンポーネント。

end

終了する日付コンポーネント。

戻り値

開始から終了までの差を計算した結果。

議論

各 DateComponents で指定されていないが、絶対日付を指定する必要があるコンポーネントについては、コンポーネントの基本値が想定されます。たとえば、year と month のみが指定されている DateComponents の場合、day が 1、hour、minute、second、nanosecond が 0 と想定されます。カレンダーの開始前に year または year の値が指定されていないカレンダー計算は推奨されません。各 DateComponents について、その timeZone プロパティが設定されている場合は、そのタイムゾーンが使用されます。calendar プロパティが設定されている場合は、受信側のカレンダーではなくそのプロパティが使用され、calendar と timeZone の両方が設定されている場合は、timeZone プロパティ値が、calendar プロパティのタイムゾーンをオーバーライドします。