dateComponents(_:from:to:)

Returns the difference between two dates specified as DateComponents.

iOS
8.0+
macOS
10.10+
tvOS
9.0+
watchOS
2.0+
func dateComponents(_ components: Set<Calendar.Component>, from start: DateComponents, to end: DateComponents) -> DateComponents

Parameters

components

Which components to compare.

start

The starting date components.

end

The ending date components.

Returns

The result of calculating the difference from start to end.

For components which are not specified in each DateComponents, but required to specify an absolute date, the base value of the component is assumed. For example, for an DateComponents with just a year and a month specified, a day of 1, and an hour, minute, second, and nanosecond of 0 are assumed. Calendrical calculations with unspecified year or year value prior to the start of a calendar are not advised. For each DateComponents, if its timeZone property is set, that time zone is used for it. If the calendar property is set, that is used rather than the receiving calendar, and if both the calendar and timeZone are set, the timeZone property value overrides the time zone of the calendar property.