Instance Method

nextDate(after:matching:options:)

Returns the next date after a given date matching the given components.

Declaration

func nextDate(after date: Date, matching comps: DateComponents, options: NSCalendar.Options = []) -> Date?

Parameters

date

The date for which to perform the calculation.

comps

The date components to match.

options

Options for the calculation. For possible values, see NSCalendar.Options.

Return Value

A new NSDate object.

Discussion

To compute a sequence of dates, use the enumerateDates(startingAfter:matching:options:using:) method instead of calling this method in a loop with the previous loop iteration's result.

See Also

Scanning Dates

func startOfDay(for: Date)

Returns the first moment of a given date as a date instance.

func enumerateDates(startingAfter: Date, matching: DateComponents, options: NSCalendar.Options = [], using: (Date?, Bool, UnsafeMutablePointer<ObjCBool>) -> Void)

Computes the dates that match (or most closely match) a given set of components, and calls the block once for each of them, until the enumeration is stopped.

func nextDate(after: Date, matchingHour: Int, minute: Int, second: Int, options: NSCalendar.Options = [])

Returns the next date after a given date that matches the given hour, minute, and second, component values.

func nextDate(after: Date, matching: NSCalendar.Unit, value: Int, options: NSCalendar.Options = [])

Returns the next date after a given date matching the given calendar unit value.

struct NSCalendar.Options

The options for arithmetic operations involving calendars.

NSWrapCalendarComponents

A legacy constant used to control overflow in date calculations.