nextDate(after:matching:matchingPolicy:repeatedTimePolicy:direction:)
Computes the next date which matches (or most closely matches) a given set of components.
Declaration
func nextDate(after date: Date, matching components: DateComponents, matchingPolicy: Calendar.MatchingPolicy, repeatedTimePolicy: Calendar.RepeatedTimePolicy = .first, direction: Calendar.SearchDirection = .forward) -> Date?Parameters
- date:
The starting date.
- components:
The components to search for.
- matchingPolicy:
Specifies the technique the search algorithm uses to find results. Default value is
.nextTime. - repeatedTimePolicy:
Specifies the behavior when multiple matches are found. Default value is
.first. - direction:
Specifies the direction in time to search. Default is
.forward.
Return Value
A Date representing the result of the search, or nil if a result could not be found.
Discussion
The general semantics follow those of the enumerateDates function. To compute a sequence of results, use the enumerateDates function, rather than looping and calling this method with the previous loop iteration’s result.